fix: 3 critical bugs + 5 non-blocking review items

Critical fixes:
1. API endpoint: /api/observers/metrics/summary doesn't exist in prod.
   Use /api/observers which returns observer data with noise_floor,
   battery_mv, packet_count, last_seen. Unwrap {observers:[...]} wrapper.

2. WS dead connection detection: add ping/pong keepalive (30s ping,
   60s read deadline reset on pong). Replaces 2s polling deadline with
   proper keepalive that detects dead connections reliably.

3. WS packet parsing: server sends {type:'packet',data:{...}} envelope.
   parseWSMessage now unwraps the envelope and reads fields from the
   correct locations: decoded.header.payloadTypeName for type,
   top-level rssi/snr/observer_name, decoded.payload for text/hops.

Non-blocking items (from Carmack review):
A. Render coalescing: 16ms tick (60fps cap) decouples packet ingestion
   from rendering. Packets accumulate in Update, View only re-renders
   on renderTickMsg.
B+D. Rune-aware truncation: truncate() and safePrefix() use []rune(s)
   for safe UTF-8 handling instead of byte slicing.
E. Dashboard sort moved from View to Update: observers pre-sorted when
   data arrives, not on every render call.

.github/workflows/deploy.yml

@@ -3,15 +3,10 @@ name: CI/CD Pipeline
 on:
   push:
     branches: [master]
-    tags: ['v*']
   pull_request:
     branches: [master]
   workflow_dispatch:
 
-permissions:
-  contents: read
-  packages: write
-
 concurrency:
   group: ci-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
@@ -23,8 +18,8 @@ env:
   STAGING_CONTAINER: corescope-staging-go
 
 # Pipeline (sequential, fail-fast):
-#   go-test → e2e-test → build-and-publish → deploy → publish-badges
-#   PRs stop after build-and-publish (no GHCR push). Master continues to deploy + badges.
+#   go-test → e2e-test → build → deploy → publish
+#   PRs stop after build. Master continues to deploy + publish.
 
 jobs:
   # ───────────────────────────────────────────────────────────────
@@ -236,108 +231,51 @@ jobs:
           include-hidden-files: true
 
   # ───────────────────────────────────────────────────────────────
-  # 3. Build & Publish Docker Image
+  # 3. Build Docker Image
   # ───────────────────────────────────────────────────────────────
-  build-and-publish:
-    name: "🏗️ Build & Publish Docker Image"
+  build:
+    name: "🏗️ Build Docker Image"
     needs: [e2e-test]
-    runs-on: [self-hosted, meshcore-runner-2]
+    runs-on: [self-hosted, meshcore-vm]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
 
+      - name: Set up Node.js 22
+        uses: actions/setup-node@v5
+        with:
+          node-version: '22'
+
       - name: Free disk space
         run: |
           docker system prune -af 2>/dev/null || true
           docker builder prune -af 2>/dev/null || true
           df -h /
 
-      - name: Compute build metadata
-        id: meta
+      - name: Build Go Docker image
         run: |
+          echo "${GITHUB_SHA::7}" > .git-commit
+          APP_VERSION=$(node -p "require('./package.json').version") \
+          GIT_COMMIT="${GITHUB_SHA::7}" \
+          APP_VERSION=$(grep -oP 'APP_VERSION:-\K[^}]+' docker-compose.yml | head -1 || echo "3.0.0")
+          GIT_COMMIT=$(git rev-parse --short HEAD)
           BUILD_TIME=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
-          GIT_COMMIT="${GITHUB_SHA::7}"
-          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
-            APP_VERSION="${GITHUB_REF#refs/tags/}"
-          else
-            APP_VERSION="edge"
-          fi
-          echo "build_time=$BUILD_TIME" >> "$GITHUB_OUTPUT"
-          echo "git_commit=$GIT_COMMIT" >> "$GITHUB_OUTPUT"
-          echo "app_version=$APP_VERSION" >> "$GITHUB_OUTPUT"
-          echo "Build: version=$APP_VERSION commit=$GIT_COMMIT time=$BUILD_TIME"
-
-      - name: Build Go Docker image (local staging)
-        run: |
-          GIT_COMMIT="${{ steps.meta.outputs.git_commit }}" \
-          APP_VERSION="${{ steps.meta.outputs.app_version }}" \
-          BUILD_TIME="${{ steps.meta.outputs.build_time }}" \
+          export APP_VERSION GIT_COMMIT BUILD_TIME
           docker compose -f "$STAGING_COMPOSE_FILE" -p corescope-staging build "$STAGING_SERVICE"
           echo "Built Go staging image ✅"
 
-      - name: Set up Docker Buildx
-        if: github.event_name == 'push'
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to GHCR
-        if: github.event_name == 'push'
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract Docker metadata
-        if: github.event_name == 'push'
-        id: docker-meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/kpa-clawbot/corescope
-          tags: |
-            type=semver,pattern=v{{version}}
-            type=semver,pattern=v{{major}}.{{minor}}
-            type=semver,pattern=v{{major}}
-            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/v') }}
-            type=edge,branch=master
-
-      - name: Build and push to GHCR
-        if: github.event_name == 'push'
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          push: true
-          platforms: linux/amd64
-          tags: ${{ steps.docker-meta.outputs.tags }}
-          labels: ${{ steps.docker-meta.outputs.labels }}
-          build-args: |
-            APP_VERSION=${{ steps.meta.outputs.app_version }}
-            GIT_COMMIT=${{ steps.meta.outputs.git_commit }}
-            BUILD_TIME=${{ steps.meta.outputs.build_time }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-
   # ───────────────────────────────────────────────────────────────
   # 4. Deploy Staging (master only)
   # ───────────────────────────────────────────────────────────────
   deploy:
     name: "🚀 Deploy Staging"
     if: github.event_name == 'push'
-    needs: [build-and-publish]
-    runs-on: [self-hosted, meshcore-runner-2]
+    needs: [build]
+    runs-on: [self-hosted, meshcore-vm]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
 
-      - name: Pull latest image from GHCR
-        run: |
-          # Try to pull the edge image from GHCR and tag for docker-compose compatibility
-          if docker pull ghcr.io/kpa-clawbot/corescope:edge; then
-            docker tag ghcr.io/kpa-clawbot/corescope:edge corescope-go:latest
-            echo "Pulled and tagged GHCR edge image ✅"
-          else
-            echo "⚠️ GHCR pull failed — falling back to locally built image"
-          fi
-
       - name: Deploy staging
         run: |
           # Stop old container and release memory

DEPLOY.md

@@ -1,131 +0,0 @@
-# Deploy CoreScope
-
-Pre-built images are published to GHCR for `linux/amd64` and `linux/arm64` (Raspberry Pi 4/5).
-
-## Quick Start
-
-### Docker run
-
-```bash
-docker run -d --name corescope \
-  -p 80:80 \
-  -v corescope-data:/app/data \
-  -e DISABLE_CADDY=true \
-  ghcr.io/kpa-clawbot/corescope:latest
-```
-
-Open `http://localhost` — done.
-
-### Docker Compose
-
-```bash
-curl -sL https://raw.githubusercontent.com/Kpa-clawbot/CoreScope/master/docker-compose.example.yml \
-  -o docker-compose.yml
-docker compose up -d
-```
-
-## Image Tags
-
-| Tag | Description |
-|-----|-------------|
-| `v3.4.1` | Pinned release (recommended for production) |
-| `v3.4` | Latest patch in v3.4.x |
-| `v3` | Latest minor+patch in v3.x |
-| `latest` | Latest release tag |
-| `edge` | Built from master — unstable, for testing |
-
-## Configuration
-
-Settings can be overridden via environment variables:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `DISABLE_CADDY` | `false` | Skip internal Caddy (set `true` behind a reverse proxy) |
-| `DISABLE_MOSQUITTO` | `false` | Skip internal MQTT broker (use external) |
-| `HTTP_PORT` | `80` | Host port mapping |
-| `DATA_DIR` | `./data` | Host path for persistent data |
-
-For advanced configuration, mount a `config.json` into `/app/data/config.json`. See `config.example.json` in the repo.
-
-## Updating
-
-```bash
-docker compose pull
-docker compose up -d
-```
-
-## Data
-
-All persistent data lives in `/app/data`:
-- `meshcore.db` — SQLite database (packets, nodes)
-- `config.json` — custom config (optional)
-- `theme.json` — custom theme (optional)
-
-**Backup:** `cp data/meshcore.db ~/backup/`
-
-## TLS
-
-Option A — **External reverse proxy** (recommended): Run with `DISABLE_CADDY=true`, put nginx/traefik/Cloudflare in front.
-
-Option B — **Built-in Caddy**: Mount a custom Caddyfile at `/etc/caddy/Caddyfile` and expose ports 80+443.
-
----
-
-## Migrating from manage.sh (existing admins)
-
-If you're currently deploying with `manage.sh` (git clone + local build), you have two options going forward:
-
-### Option A: Keep using manage.sh (no changes needed)
-
-`manage.sh update` continues to work exactly as before — it fetches the latest tag, builds locally, and restarts. Nothing breaks.
-
-```bash
-./manage.sh update          # latest release
-./manage.sh update v3.5.0   # specific version
-```
-
-### Option B: Switch to pre-built images (recommended)
-
-Pre-built images skip the build step entirely — faster updates, no Go toolchain needed.
-
-**One-time migration:**
-
-1. Stop the current deployment:
-   ```bash
-   ./manage.sh stop
-   ```
-
-2. Your data is in `~/meshcore-data/` (or whatever `PROD_DATA_DIR` is set to). It's untouched — the database, config, and theme files persist.
-
-3. Copy `docker-compose.example.yml` to where you want to run from:
-   ```bash
-   cp docker-compose.example.yml ~/docker-compose.yml
-   ```
-
-4. Start with the pre-built image:
-   ```bash
-   cd ~ && docker compose up -d
-   ```
-
-5. Verify it picked up your existing data:
-   ```bash
-   curl http://localhost/api/stats
-   ```
-
-**Updates after migration:**
-```bash
-docker compose pull && docker compose up -d
-```
-
-### What about manage.sh features?
-
-| manage.sh command | Pre-built equivalent |
-|---|---|
-| `./manage.sh update` | `docker compose pull && docker compose up -d` |
-| `./manage.sh stop` | `docker compose down` |
-| `./manage.sh start` | `docker compose up -d` |
-| `./manage.sh logs` | `docker compose logs -f` |
-| `./manage.sh status` | `docker compose ps` |
-| `./manage.sh setup` | Copy `docker-compose.example.yml`, edit env vars |
-
-`manage.sh` remains available for advanced use cases (building from source, custom patches, development). Pre-built images are recommended for most production deployments.

Dockerfile

@@ -42,8 +42,6 @@ RUN echo "unknown" > .git-commit
 # Supervisor + Mosquitto + Caddy config
 COPY docker/supervisord-go.conf /etc/supervisor/conf.d/supervisord.conf
 COPY docker/supervisord-go-no-mosquitto.conf /etc/supervisor/conf.d/supervisord-no-mosquitto.conf
-COPY docker/supervisord-go-no-caddy.conf /etc/supervisor/conf.d/supervisord-no-caddy.conf
-COPY docker/supervisord-go-no-mosquitto-no-caddy.conf /etc/supervisor/conf.d/supervisord-no-mosquitto-no-caddy.conf
 COPY docker/mosquitto.conf /etc/mosquitto/mosquitto.conf
 COPY docker/Caddyfile /etc/caddy/Caddyfile
 

Dockerfile.go

@@ -40,9 +40,6 @@ RUN if [ ! -f .git-commit ]; then echo "unknown" > .git-commit; fi
 
 # Supervisor + Mosquitto + Caddy config
 COPY docker/supervisord-go.conf /etc/supervisor/conf.d/supervisord.conf
-COPY docker/supervisord-go-no-mosquitto.conf /etc/supervisor/conf.d/supervisord-no-mosquitto.conf
-COPY docker/supervisord-go-no-caddy.conf /etc/supervisor/conf.d/supervisord-no-caddy.conf
-COPY docker/supervisord-go-no-mosquitto-no-caddy.conf /etc/supervisor/conf.d/supervisord-no-mosquitto-no-caddy.conf
 COPY docker/mosquitto.conf /etc/mosquitto/mosquitto.conf
 COPY docker/Caddyfile /etc/caddy/Caddyfile
 

README.md

@@ -74,23 +74,9 @@ Full experience on your phone — proper touch controls, iOS safe area support,
 
 ## Quick Start
 
-### Pre-built Image (Recommended)
+### Docker (Recommended)
 
-No build step required — just run:
-
-```bash
-docker run -d --name corescope \
-  -p 80:80 \
-  -v corescope-data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:latest
-```
-
-Open `http://localhost` — done. No config file needed; CoreScope starts with sensible defaults.
-
-See [DEPLOY.md](DEPLOY.md) for image tags, Docker Compose, and migration from `manage.sh`.
-See [docs/deployment.md](docs/deployment.md) for the full deployment guide — MQTT setup, HTTPS options, backups, monitoring, and troubleshooting.
-
-### Build from Source
+No Go installation needed — everything builds inside the container.
 
 ```bash
 git clone https://github.com/Kpa-clawbot/CoreScope.git
@@ -109,6 +95,8 @@ The setup wizard walks you through config, domain, HTTPS, build, and run.
 ./manage.sh help         # All commands
 ```
 
+See [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for the full deployment guide — HTTPS options (auto cert, bring your own, Cloudflare Tunnel), MQTT security, backups, and troubleshooting.
+
 ### Configure
 
 Copy `config.example.json` to `config.json` and edit:
@@ -254,8 +242,6 @@ Contributions welcome. Please read [AGENTS.md](AGENTS.md) for coding conventions
 
 **Live instance:** [analyzer.00id.net](https://analyzer.00id.net) — all API endpoints are public, no auth required.
 
-**API Documentation:** CoreScope auto-generates an OpenAPI 3.0 spec. Browse the interactive Swagger UI at [`/api/docs`](https://analyzer.00id.net/api/docs) or fetch the machine-readable spec at [`/api/spec`](https://analyzer.00id.net/api/spec).
-
 ## License
 
 MIT

cmd/ingestor/config.go

@@ -2,9 +2,7 @@ package main
 
 import (
 	"encoding/json"
-	"errors"
 	"fmt"
-	"log"
 	"os"
 	"strings"
 
@@ -81,21 +79,15 @@ func (c *Config) NodeDaysOrDefault() int {
 }
 
 // LoadConfig reads configuration from a JSON file, with env var overrides.
-// If the config file does not exist, sensible defaults are used (zero-config startup).
 func LoadConfig(path string) (*Config, error) {
-	var cfg Config
-
 	data, err := os.ReadFile(path)
 	if err != nil {
-		if !errors.Is(err, os.ErrNotExist) {
-			return nil, fmt.Errorf("reading config %s: %w", path, err)
-		}
-		// Config file doesn't exist — use defaults (zero-config mode)
-		log.Printf("config file %s not found, using sensible defaults", path)
-	} else {
-		if err := json.Unmarshal(data, &cfg); err != nil {
-			return nil, fmt.Errorf("parsing config %s: %w", path, err)
-		}
+		return nil, fmt.Errorf("reading config %s: %w", path, err)
+	}
+
+	var cfg Config
+	if err := json.Unmarshal(data, &cfg); err != nil {
+		return nil, fmt.Errorf("parsing config %s: %w", path, err)
 	}
 
 	// Env var overrides
@@ -129,16 +121,6 @@ func LoadConfig(path string) (*Config, error) {
 		}}
 	}
 
-	// Default MQTT source: connect to localhost broker when no sources configured
-	if len(cfg.MQTTSources) == 0 {
-		cfg.MQTTSources = []MQTTSource{{
-			Name:   "local",
-			Broker: "mqtt://localhost:1883",
-			Topics: []string{"meshcore/#"},
-		}}
-		log.Printf("no MQTT sources configured, defaulting to mqtt://localhost:1883")
-	}
-
 	return &cfg, nil
 }
 

cmd/ingestor/config_test.go

@@ -32,25 +32,9 @@ func TestLoadConfigValidJSON(t *testing.T) {
 }
 
 func TestLoadConfigMissingFile(t *testing.T) {
-	t.Setenv("DB_PATH", "")
-	t.Setenv("MQTT_BROKER", "")
-
-	cfg, err := LoadConfig("/nonexistent/path/config.json")
-	if err != nil {
-		t.Fatalf("missing config should not error (zero-config mode), got: %v", err)
-	}
-	if cfg.DBPath != "data/meshcore.db" {
-		t.Errorf("dbPath=%s, want data/meshcore.db", cfg.DBPath)
-	}
-	// Should default to localhost MQTT
-	if len(cfg.MQTTSources) != 1 {
-		t.Fatalf("mqttSources len=%d, want 1", len(cfg.MQTTSources))
-	}
-	if cfg.MQTTSources[0].Broker != "mqtt://localhost:1883" {
-		t.Errorf("default broker=%s, want mqtt://localhost:1883", cfg.MQTTSources[0].Broker)
-	}
-	if cfg.MQTTSources[0].Name != "local" {
-		t.Errorf("default source name=%s, want local", cfg.MQTTSources[0].Name)
+	_, err := LoadConfig("/nonexistent/path/config.json")
+	if err == nil {
+		t.Error("expected error for missing file")
 	}
 }
 
@@ -212,8 +196,8 @@ func TestLoadConfigLegacyMQTTEmptyBroker(t *testing.T) {
 	if err != nil {
 		t.Fatal(err)
 	}
-	if len(cfg.MQTTSources) != 1 || cfg.MQTTSources[0].Name != "local" {
-		t.Errorf("mqttSources should default to local broker when legacy broker is empty, got %v", cfg.MQTTSources)
+	if len(cfg.MQTTSources) != 0 {
+		t.Errorf("mqttSources should be empty when legacy broker is empty, got %d", len(cfg.MQTTSources))
 	}
 }
 

cmd/ingestor/coverage_boost_test.go

@@ -461,7 +461,7 @@ func TestDecodeAdvertLocationTruncated(t *testing.T) {
 	buf[100] = 0x11
 	// Only 4 bytes after flags — not enough for full location (needs 8)
 
-	p := decodeAdvert(buf[:105], false)
+	p := decodeAdvert(buf[:105])
 	if p.Error != "" {
 		t.Fatalf("error: %s", p.Error)
 	}
@@ -483,7 +483,7 @@ func TestDecodeAdvertFeat1Truncated(t *testing.T) {
 	buf[100] = 0x21
 	// Only 1 byte after flags — not enough for feat1 (needs 2)
 
-	p := decodeAdvert(buf[:102], false)
+	p := decodeAdvert(buf[:102])
 	if p.Feat1 != nil {
 		t.Error("feat1 should be nil with truncated data")
 	}
@@ -504,7 +504,7 @@ func TestDecodeAdvertFeat2Truncated(t *testing.T) {
 	buf[102] = 0x00
 	// Only 1 byte left — not enough for feat2
 
-	p := decodeAdvert(buf[:104], false)
+	p := decodeAdvert(buf[:104])
 	if p.Feat1 == nil {
 		t.Error("feat1 should be set")
 	}
@@ -544,7 +544,7 @@ func TestDecodeAdvertSensorBadTelemetry(t *testing.T) {
 	buf[105] = 0x20
 	buf[106] = 0x4E
 
-	p := decodeAdvert(buf[:107], false)
+	p := decodeAdvert(buf[:107])
 	if p.BatteryMv != nil {
 		t.Error("battery_mv=0 should be nil")
 	}
@@ -740,7 +740,7 @@ func TestDecodeAdvertSensorNoName(t *testing.T) {
 	buf[103] = 0xC4
 	buf[104] = 0x09
 
-	p := decodeAdvert(buf[:105], false)
+	p := decodeAdvert(buf[:105])
 	if p.Error != "" {
 		t.Fatalf("error: %s", p.Error)
 	}
@@ -835,7 +835,7 @@ func TestDecodePacketNoPathByteAfterHeader(t *testing.T) {
 	// Non-transport route, but only header byte (no path byte)
 	// Actually 0A alone = 1 byte, but we need >= 2
 	// Header + exactly at offset boundary
-	_, err := DecodePacket("0A", nil, false)
+	_, err := DecodePacket("0A", nil)
 	if err == nil {
 		t.Error("should error - too short")
 	}
@@ -856,7 +856,7 @@ func TestDecodeAdvertNameNoNull(t *testing.T) {
 	// Name without null terminator — goes to end of buffer
 	copy(buf[101:], []byte("LongNameNoNull"))
 
-	p := decodeAdvert(buf[:115], false)
+	p := decodeAdvert(buf[:115])
 	if p.Name != "LongNameNoNull" {
 		t.Errorf("name=%q, want LongNameNoNull", p.Name)
 	}

cmd/ingestor/db_test.go

@@ -576,7 +576,7 @@ func TestEndToEndIngest(t *testing.T) {
 	// Simulate full pipeline: decode + insert
 	rawHex := "120046D62DE27D4C5194D7821FC5A34A45565DCC2537B300B9AB6275255CEFB65D840CE5C169C94C9AED39E8BCB6CB6EB0335497A198B33A1A610CD3B03D8DCFC160900E5244280323EE0B44CACAB8F02B5B38B91CFA18BD067B0B5E63E94CFC85F758A8530B9240933402E0E6B8F84D5252322D52"
 
-	decoded, err := DecodePacket(rawHex, nil, false)
+	decoded, err := DecodePacket(rawHex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -764,7 +764,7 @@ func TestInsertTransmissionNilSNRRSSI(t *testing.T) {
 
 func TestBuildPacketData(t *testing.T) {
 	rawHex := "0A00D69FD7A5A7475DB07337749AE61FA53A4788E976"
-	decoded, err := DecodePacket(rawHex, nil, false)
+	decoded, err := DecodePacket(rawHex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -818,7 +818,7 @@ func TestBuildPacketData(t *testing.T) {
 func TestBuildPacketDataWithHops(t *testing.T) {
 	// A packet with actual hops in the path
 	raw := "0505AABBCCDDEE" + strings.Repeat("00", 10)
-	decoded, err := DecodePacket(raw, nil, false)
+	decoded, err := DecodePacket(raw, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -834,7 +834,7 @@ func TestBuildPacketDataWithHops(t *testing.T) {
 }
 
 func TestBuildPacketDataNilSNRRSSI(t *testing.T) {
-	decoded, _ := DecodePacket("0A00"+strings.Repeat("00", 10), nil, false)
+	decoded, _ := DecodePacket("0A00"+strings.Repeat("00", 10), nil)
 	msg := &MQTTPacketMessage{Raw: "0A00" + strings.Repeat("00", 10)}
 	pkt := BuildPacketData(msg, decoded, "", "")
 
@@ -1624,7 +1624,7 @@ func TestObsTimestampIndexMigration(t *testing.T) {
 
 func TestBuildPacketDataScoreAndDirection(t *testing.T) {
 	rawHex := "0A00D69FD7A5A7475DB07337749AE61FA53A4788E976"
-	decoded, err := DecodePacket(rawHex, nil, false)
+	decoded, err := DecodePacket(rawHex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1647,7 +1647,7 @@ func TestBuildPacketDataScoreAndDirection(t *testing.T) {
 }
 
 func TestBuildPacketDataNilScoreDirection(t *testing.T) {
-	decoded, _ := DecodePacket("0A00"+strings.Repeat("00", 10), nil, false)
+	decoded, _ := DecodePacket("0A00"+strings.Repeat("00", 10), nil)
 	msg := &MQTTPacketMessage{Raw: "0A00" + strings.Repeat("00", 10)}
 	pkt := BuildPacketData(msg, decoded, "", "")
 

cmd/ingestor/decoder.go

@@ -11,8 +11,6 @@ import (
 	"math"
 	"strings"
 	"unicode/utf8"
-
-	"github.com/meshcore-analyzer/sigvalidate"
 )
 
 // Route type constants (header bits 1-0)
@@ -111,7 +109,6 @@ type Payload struct {
 	Timestamp     uint32       `json:"timestamp,omitempty"`
 	TimestampISO  string       `json:"timestampISO,omitempty"`
 	Signature     string       `json:"signature,omitempty"`
-	SignatureValid *bool       `json:"signatureValid,omitempty"`
 	Flags         *AdvertFlags `json:"flags,omitempty"`
 	Lat           *float64     `json:"lat,omitempty"`
 	Lon           *float64     `json:"lon,omitempty"`
@@ -218,7 +215,7 @@ func decodeAck(buf []byte) Payload {
 	}
 }
 
-func decodeAdvert(buf []byte, validateSignatures bool) Payload {
+func decodeAdvert(buf []byte) Payload {
 	if len(buf) < 100 {
 		return Payload{Type: "ADVERT", Error: "too short for advert", RawHex: hex.EncodeToString(buf)}
 	}
@@ -236,11 +233,6 @@ func decodeAdvert(buf []byte, validateSignatures bool) Payload {
 		Signature:    signature,
 	}
 
-	if validateSignatures {
-		valid := sigvalidate.ValidateAdvertSignature(buf[0:32], buf[36:100], timestamp, appdata)
-		p.SignatureValid = &valid
-	}
-
 	if len(appdata) > 0 {
 		flags := appdata[0]
 		advType := int(flags & 0x0F)
@@ -514,7 +506,7 @@ func decodeTrace(buf []byte) Payload {
 	return p
 }
 
-func decodePayload(payloadType int, buf []byte, channelKeys map[string]string, validateSignatures bool) Payload {
+func decodePayload(payloadType int, buf []byte, channelKeys map[string]string) Payload {
 	switch payloadType {
 	case PayloadREQ:
 		return decodeEncryptedPayload("REQ", buf)
@@ -525,7 +517,7 @@ func decodePayload(payloadType int, buf []byte, channelKeys map[string]string, v
 	case PayloadACK:
 		return decodeAck(buf)
 	case PayloadADVERT:
-		return decodeAdvert(buf, validateSignatures)
+		return decodeAdvert(buf)
 	case PayloadGRP_TXT:
 		return decodeGrpTxt(buf, channelKeys)
 	case PayloadANON_REQ:
@@ -540,7 +532,7 @@ func decodePayload(payloadType int, buf []byte, channelKeys map[string]string, v
 }
 
 // DecodePacket decodes a hex-encoded MeshCore packet.
-func DecodePacket(hexString string, channelKeys map[string]string, validateSignatures bool) (*DecodedPacket, error) {
+func DecodePacket(hexString string, channelKeys map[string]string) (*DecodedPacket, error) {
 	hexString = strings.ReplaceAll(hexString, " ", "")
 	hexString = strings.ReplaceAll(hexString, "\n", "")
 	hexString = strings.ReplaceAll(hexString, "\r", "")
@@ -578,7 +570,7 @@ func DecodePacket(hexString string, channelKeys map[string]string, validateSigna
 	offset += bytesConsumed
 
 	payloadBuf := buf[offset:]
-	payload := decodePayload(header.PayloadType, payloadBuf, channelKeys, validateSignatures)
+	payload := decodePayload(header.PayloadType, payloadBuf, channelKeys)
 
 	// TRACE packets store hop IDs in the payload (buf[9:]) rather than the header
 	// path field. The header path byte still encodes hashSize in bits 6-7, which
@@ -595,16 +587,6 @@ func DecodePacket(hexString string, channelKeys map[string]string, validateSigna
 		}
 	}
 
-	// Zero-hop direct packets have hash_count=0 (lower 6 bits of pathByte),
-	// which makes the generic formula yield a bogus hashSize. Reset to 0
-	// (unknown) so API consumers get correct data. We mask with 0x3F to check
-	// only hash_count, matching the JS frontend approach — the upper hash_size
-	// bits are meaningless when there are no hops. Skip TRACE packets — they
-	// use hashSize to parse hops from the payload above.
-	if (header.RouteType == RouteDirect || header.RouteType == RouteTransportDirect) && pathByte&0x3F == 0 && header.PayloadType != PayloadTRACE {
-		path.HashSize = 0
-	}
-
 	return &DecodedPacket{
 		Header:         header,
 		TransportCodes: tc,

cmd/ingestor/decoder_test.go

@@ -2,7 +2,6 @@ package main
 
 import (
 	"crypto/aes"
-	"crypto/ed25519"
 	"crypto/hmac"
 	"crypto/sha256"
 	"encoding/binary"
@@ -10,8 +9,6 @@ import (
 	"math"
 	"strings"
 	"testing"
-
-	"github.com/meshcore-analyzer/sigvalidate"
 )
 
 func TestDecodeHeaderRoutTypes(t *testing.T) {
@@ -58,7 +55,7 @@ func TestDecodeHeaderPayloadTypes(t *testing.T) {
 
 func TestDecodePathZeroHops(t *testing.T) {
 	// 0x00: 0 hops, 1-byte hashes
-	pkt, err := DecodePacket("0500"+strings.Repeat("00", 10), nil, false)
+	pkt, err := DecodePacket("0500"+strings.Repeat("00", 10), nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -75,7 +72,7 @@ func TestDecodePathZeroHops(t *testing.T) {
 
 func TestDecodePath1ByteHashes(t *testing.T) {
 	// 0x05: 5 hops, 1-byte hashes → 5 path bytes
-	pkt, err := DecodePacket("0505"+"AABBCCDDEE"+strings.Repeat("00", 10), nil, false)
+	pkt, err := DecodePacket("0505"+"AABBCCDDEE"+strings.Repeat("00", 10), nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -98,7 +95,7 @@ func TestDecodePath1ByteHashes(t *testing.T) {
 
 func TestDecodePath2ByteHashes(t *testing.T) {
 	// 0x45: 5 hops, 2-byte hashes
-	pkt, err := DecodePacket("0545"+"AA11BB22CC33DD44EE55"+strings.Repeat("00", 10), nil, false)
+	pkt, err := DecodePacket("0545"+"AA11BB22CC33DD44EE55"+strings.Repeat("00", 10), nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -115,7 +112,7 @@ func TestDecodePath2ByteHashes(t *testing.T) {
 
 func TestDecodePath3ByteHashes(t *testing.T) {
 	// 0x8A: 10 hops, 3-byte hashes
-	pkt, err := DecodePacket("058A"+strings.Repeat("AA11FF", 10)+strings.Repeat("00", 10), nil, false)
+	pkt, err := DecodePacket("058A"+strings.Repeat("AA11FF", 10)+strings.Repeat("00", 10), nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -134,7 +131,7 @@ func TestTransportCodes(t *testing.T) {
 	// Route type 0 (TRANSPORT_FLOOD) should have transport codes
 	// Firmware order: header + transport_codes(4) + path_len + path + payload
 	hex := "14" + "AABB" + "CCDD" + "00" + strings.Repeat("00", 10)
-	pkt, err := DecodePacket(hex, nil, false)
+	pkt, err := DecodePacket(hex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -152,7 +149,7 @@ func TestTransportCodes(t *testing.T) {
 	}
 
 	// Route type 1 (FLOOD) should NOT have transport codes
-	pkt2, err := DecodePacket("0500"+strings.Repeat("00", 10), nil, false)
+	pkt2, err := DecodePacket("0500"+strings.Repeat("00", 10), nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -172,7 +169,7 @@ func TestDecodeAdvertFull(t *testing.T) {
 	name := "546573744E6F6465" // "TestNode"
 
 	hex := "1200" + pubkey + timestamp + signature + flags + lat + lon + name
-	pkt, err := DecodePacket(hex, nil, false)
+	pkt, err := DecodePacket(hex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -230,7 +227,7 @@ func TestDecodeAdvertTypeEnums(t *testing.T) {
 	makeAdvert := func(flagsByte byte) *DecodedPacket {
 		hex := "1200" + strings.Repeat("AA", 32) + "00000000" + strings.Repeat("BB", 64) +
 			strings.ToUpper(string([]byte{hexDigit(flagsByte>>4), hexDigit(flagsByte & 0x0f)}))
-		pkt, err := DecodePacket(hex, nil, false)
+		pkt, err := DecodePacket(hex, nil)
 		if err != nil {
 			t.Fatal(err)
 		}
@@ -275,7 +272,7 @@ func hexDigit(v byte) byte {
 
 func TestDecodeAdvertNoLocationNoName(t *testing.T) {
 	hex := "1200" + strings.Repeat("CC", 32) + "00000000" + strings.Repeat("DD", 64) + "02"
-	pkt, err := DecodePacket(hex, nil, false)
+	pkt, err := DecodePacket(hex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -294,7 +291,7 @@ func TestDecodeAdvertNoLocationNoName(t *testing.T) {
 }
 
 func TestGoldenFixtureTxtMsg(t *testing.T) {
-	pkt, err := DecodePacket("0A00D69FD7A5A7475DB07337749AE61FA53A4788E976", nil, false)
+	pkt, err := DecodePacket("0A00D69FD7A5A7475DB07337749AE61FA53A4788E976", nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -317,7 +314,7 @@ func TestGoldenFixtureTxtMsg(t *testing.T) {
 
 func TestGoldenFixtureAdvert(t *testing.T) {
 	rawHex := "120046D62DE27D4C5194D7821FC5A34A45565DCC2537B300B9AB6275255CEFB65D840CE5C169C94C9AED39E8BCB6CB6EB0335497A198B33A1A610CD3B03D8DCFC160900E5244280323EE0B44CACAB8F02B5B38B91CFA18BD067B0B5E63E94CFC85F758A8530B9240933402E0E6B8F84D5252322D52"
-	pkt, err := DecodePacket(rawHex, nil, false)
+	pkt, err := DecodePacket(rawHex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -340,7 +337,7 @@ func TestGoldenFixtureAdvert(t *testing.T) {
 
 func TestGoldenFixtureUnicodeAdvert(t *testing.T) {
 	rawHex := "120073CFF971E1CB5754A742C152B2D2E0EB108A19B246D663ED8898A72C4A5AD86EA6768E66694B025EDF6939D5C44CFF719C5D5520E5F06B20680A83AD9C2C61C3227BBB977A85EE462F3553445FECF8EDD05C234ECE217272E503F14D6DF2B1B9B133890C923CDF3002F8FDC1F85045414BF09F8CB3"
-	pkt, err := DecodePacket(rawHex, nil, false)
+	pkt, err := DecodePacket(rawHex, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -357,14 +354,14 @@ func TestGoldenFixtureUnicodeAdvert(t *testing.T) {
 }
 
 func TestDecodePacketTooShort(t *testing.T) {
-	_, err := DecodePacket("FF", nil, false)
+	_, err := DecodePacket("FF", nil)
 	if err == nil {
 		t.Error("expected error for 1-byte packet")
 	}
 }
 
 func TestDecodePacketInvalidHex(t *testing.T) {
-	_, err := DecodePacket("ZZZZ", nil, false)
+	_, err := DecodePacket("ZZZZ", nil)
 	if err == nil {
 		t.Error("expected error for invalid hex")
 	}
@@ -571,7 +568,7 @@ func TestDecodeTracePathParsing(t *testing.T) {
 	// Packet from issue #276: 260001807dca00000000007d547d
 	// Path byte 0x00 → hashSize=1, hops in payload at buf[9:] = 7d 54 7d
 	// Expected path: ["7D", "54", "7D"]
-	pkt, err := DecodePacket("260001807dca00000000007d547d", nil, false)
+	pkt, err := DecodePacket("260001807dca00000000007d547d", nil)
 	if err != nil {
 		t.Fatalf("DecodePacket error: %v", err)
 	}
@@ -593,7 +590,7 @@ func TestDecodeTracePathParsing(t *testing.T) {
 }
 
 func TestDecodeAdvertShort(t *testing.T) {
-	p := decodeAdvert(make([]byte, 50), false)
+	p := decodeAdvert(make([]byte, 50))
 	if p.Error != "too short for advert" {
 		t.Errorf("expected 'too short for advert' error, got %q", p.Error)
 	}
@@ -631,7 +628,7 @@ func TestDecodeEncryptedPayloadValid(t *testing.T) {
 
 func TestDecodePayloadGRPData(t *testing.T) {
 	buf := []byte{0x01, 0x02, 0x03}
-	p := decodePayload(PayloadGRP_DATA, buf, nil, false)
+	p := decodePayload(PayloadGRP_DATA, buf, nil)
 	if p.Type != "UNKNOWN" {
 		t.Errorf("type=%s, want UNKNOWN", p.Type)
 	}
@@ -642,7 +639,7 @@ func TestDecodePayloadGRPData(t *testing.T) {
 
 func TestDecodePayloadRAWCustom(t *testing.T) {
 	buf := []byte{0xFF, 0xFE}
-	p := decodePayload(PayloadRAW_CUSTOM, buf, nil, false)
+	p := decodePayload(PayloadRAW_CUSTOM, buf, nil)
 	if p.Type != "UNKNOWN" {
 		t.Errorf("type=%s, want UNKNOWN", p.Type)
 	}
@@ -650,49 +647,49 @@ func TestDecodePayloadRAWCustom(t *testing.T) {
 
 func TestDecodePayloadAllTypes(t *testing.T) {
 	// REQ
-	p := decodePayload(PayloadREQ, make([]byte, 10), nil, false)
+	p := decodePayload(PayloadREQ, make([]byte, 10), nil)
 	if p.Type != "REQ" {
 		t.Errorf("REQ: type=%s", p.Type)
 	}
 
 	// RESPONSE
-	p = decodePayload(PayloadRESPONSE, make([]byte, 10), nil, false)
+	p = decodePayload(PayloadRESPONSE, make([]byte, 10), nil)
 	if p.Type != "RESPONSE" {
 		t.Errorf("RESPONSE: type=%s", p.Type)
 	}
 
 	// TXT_MSG
-	p = decodePayload(PayloadTXT_MSG, make([]byte, 10), nil, false)
+	p = decodePayload(PayloadTXT_MSG, make([]byte, 10), nil)
 	if p.Type != "TXT_MSG" {
 		t.Errorf("TXT_MSG: type=%s", p.Type)
 	}
 
 	// ACK
-	p = decodePayload(PayloadACK, make([]byte, 10), nil, false)
+	p = decodePayload(PayloadACK, make([]byte, 10), nil)
 	if p.Type != "ACK" {
 		t.Errorf("ACK: type=%s", p.Type)
 	}
 
 	// GRP_TXT
-	p = decodePayload(PayloadGRP_TXT, make([]byte, 10), nil, false)
+	p = decodePayload(PayloadGRP_TXT, make([]byte, 10), nil)
 	if p.Type != "GRP_TXT" {
 		t.Errorf("GRP_TXT: type=%s", p.Type)
 	}
 
 	// ANON_REQ
-	p = decodePayload(PayloadANON_REQ, make([]byte, 40), nil, false)
+	p = decodePayload(PayloadANON_REQ, make([]byte, 40), nil)
 	if p.Type != "ANON_REQ" {
 		t.Errorf("ANON_REQ: type=%s", p.Type)
 	}
 
 	// PATH
-	p = decodePayload(PayloadPATH, make([]byte, 10), nil, false)
+	p = decodePayload(PayloadPATH, make([]byte, 10), nil)
 	if p.Type != "PATH" {
 		t.Errorf("PATH: type=%s", p.Type)
 	}
 
 	// TRACE
-	p = decodePayload(PayloadTRACE, make([]byte, 20), nil, false)
+	p = decodePayload(PayloadTRACE, make([]byte, 20), nil)
 	if p.Type != "TRACE" {
 		t.Errorf("TRACE: type=%s", p.Type)
 	}
@@ -928,7 +925,7 @@ func TestComputeContentHashLongFallback(t *testing.T) {
 
 func TestDecodePacketWithWhitespace(t *testing.T) {
 	raw := "0A 00 D6 9F D7 A5 A7 47 5D B0 73 37 74 9A E6 1F A5 3A 47 88 E9 76"
-	pkt, err := DecodePacket(raw, nil, false)
+	pkt, err := DecodePacket(raw, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -939,7 +936,7 @@ func TestDecodePacketWithWhitespace(t *testing.T) {
 
 func TestDecodePacketWithNewlines(t *testing.T) {
 	raw := "0A00\nD69F\r\nD7A5A7475DB07337749AE61FA53A4788E976"
-	pkt, err := DecodePacket(raw, nil, false)
+	pkt, err := DecodePacket(raw, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -950,7 +947,7 @@ func TestDecodePacketWithNewlines(t *testing.T) {
 
 func TestDecodePacketTransportRouteTooShort(t *testing.T) {
 	// TRANSPORT_FLOOD (route=0) but only 2 bytes total → too short for transport codes
-	_, err := DecodePacket("1400", nil, false)
+	_, err := DecodePacket("1400", nil)
 	if err == nil {
 		t.Error("expected error for transport route with too-short buffer")
 	}
@@ -1010,7 +1007,7 @@ func TestDecodeHeaderUnknownTypes(t *testing.T) {
 
 func TestDecodePayloadMultipart(t *testing.T) {
 	// MULTIPART (0x0A) falls through to default → UNKNOWN
-	p := decodePayload(PayloadMULTIPART, []byte{0x01, 0x02}, nil, false)
+	p := decodePayload(PayloadMULTIPART, []byte{0x01, 0x02}, nil)
 	if p.Type != "UNKNOWN" {
 		t.Errorf("MULTIPART type=%s, want UNKNOWN", p.Type)
 	}
@@ -1018,7 +1015,7 @@ func TestDecodePayloadMultipart(t *testing.T) {
 
 func TestDecodePayloadControl(t *testing.T) {
 	// CONTROL (0x0B) falls through to default → UNKNOWN
-	p := decodePayload(PayloadCONTROL, []byte{0x01, 0x02}, nil, false)
+	p := decodePayload(PayloadCONTROL, []byte{0x01, 0x02}, nil)
 	if p.Type != "UNKNOWN" {
 		t.Errorf("CONTROL type=%s, want UNKNOWN", p.Type)
 	}
@@ -1042,7 +1039,7 @@ func TestDecodePathTruncatedBuffer(t *testing.T) {
 func TestDecodeFloodAdvert5Hops(t *testing.T) {
 	// From test-decoder.js Test 1
 	raw := "11451000D818206D3AAC152C8A91F89957E6D30CA51F36E28790228971C473B755F244F718754CF5EE4A2FD58D944466E42CDED140C66D0CC590183E32BAF40F112BE8F3F2BDF6012B4B2793C52F1D36F69EE054D9A05593286F78453E56C0EC4A3EB95DDA2A7543FCCC00B939CACC009278603902FC12BCF84B706120526F6F6620536F6C6172"
-	pkt, err := DecodePacket(raw, nil, false)
+	pkt, err := DecodePacket(raw, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1413,7 +1410,7 @@ func TestDecodeAdvertWithTelemetry(t *testing.T) {
 		name + nullTerm +
 		hex.EncodeToString(batteryLE) + hex.EncodeToString(tempLE)
 
-	pkt, err := DecodePacket(hexStr, nil, false)
+	pkt, err := DecodePacket(hexStr, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1452,7 +1449,7 @@ func TestDecodeAdvertWithTelemetryNegativeTemp(t *testing.T) {
 		name + nullTerm +
 		hex.EncodeToString(batteryLE) + hex.EncodeToString(tempLE)
 
-	pkt, err := DecodePacket(hexStr, nil, false)
+	pkt, err := DecodePacket(hexStr, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1479,7 +1476,7 @@ func TestDecodeAdvertWithoutTelemetry(t *testing.T) {
 	name := hex.EncodeToString([]byte("Node1"))
 
 	hexStr := "1200" + pubkey + timestamp + signature + flags + name
-	pkt, err := DecodePacket(hexStr, nil, false)
+	pkt, err := DecodePacket(hexStr, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1506,7 +1503,7 @@ func TestDecodeAdvertNonSensorIgnoresTelemetryBytes(t *testing.T) {
 	extraBytes := "B40ED403" // battery-like and temp-like bytes
 
 	hexStr := "1200" + pubkey + timestamp + signature + flags + name + nullTerm + extraBytes
-	pkt, err := DecodePacket(hexStr, nil, false)
+	pkt, err := DecodePacket(hexStr, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1534,7 +1531,7 @@ func TestDecodeAdvertTelemetryZeroTemp(t *testing.T) {
 		name + nullTerm +
 		hex.EncodeToString(batteryLE) + hex.EncodeToString(tempLE)
 
-	pkt, err := DecodePacket(hexStr, nil, false)
+	pkt, err := DecodePacket(hexStr, nil)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -1545,153 +1542,3 @@ func TestDecodeAdvertTelemetryZeroTemp(t *testing.T) {
 		t.Errorf("temperature_c=%f, want 0.0", *pkt.Payload.TemperatureC)
 	}
 }
-
-func repeatHex(byteHex string, n int) string {
-	s := ""
-	for i := 0; i < n; i++ {
-		s += byteHex
-	}
-	return s
-}
-
-func TestZeroHopDirectHashSize(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x00 → hash_count=0, hash_size bits=0 → should get HashSize=0
-	hex := "02" + "00" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, nil, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("DIRECT zero-hop: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestZeroHopDirectHashSizeWithNonZeroUpperBits(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x40 → hash_count=0, hash_size bits=01 → should still get HashSize=0
-	hex := "02" + "40" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, nil, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("DIRECT zero-hop with hash_size bits set: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestNonDirectZeroPathByteKeepsHashSize(t *testing.T) {
-	// FLOOD (RouteType=1) + REQ (PayloadType=0) → header byte = 0x01
-	// pathByte=0x00 → non-DIRECT should keep HashSize=1
-	hex := "01" + "00" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, nil, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 1 {
-		t.Errorf("FLOOD zero pathByte: want HashSize=1, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestDirectNonZeroHopKeepsHashSize(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x01 → hash_count=1, hash_size=1 → should keep HashSize=1
-	hex := "02" + "01" + repeatHex("BB", 21)
-	pkt, err := DecodePacket(hex, nil, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 1 {
-		t.Errorf("DIRECT with 1 hop: want HashSize=1, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestValidateAdvertSignature(t *testing.T) {
-	// Generate a real ed25519 key pair
-	pub, priv, err := ed25519.GenerateKey(nil)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var timestamp uint32 = 1234567890
-	appdata := []byte{0x02, 0x11, 0x22} // flags + some data
-
-	// Build the message the same way ValidateAdvertSignature does
-	message := make([]byte, 32+4+len(appdata))
-	copy(message[0:32], pub)
-	binary.LittleEndian.PutUint32(message[32:36], timestamp)
-	copy(message[36:], appdata)
-
-	sig := ed25519.Sign(priv, message)
-
-	// Valid signature
-	if !sigvalidate.ValidateAdvertSignature(pub, sig, timestamp, appdata) {
-		t.Error("expected valid signature")
-	}
-
-	// Tampered appdata → invalid
-	badAppdata := []byte{0x03, 0x11, 0x22}
-	if sigvalidate.ValidateAdvertSignature(pub, sig, timestamp, badAppdata) {
-		t.Error("expected invalid signature with tampered appdata")
-	}
-
-	// Wrong timestamp → invalid
-	if sigvalidate.ValidateAdvertSignature(pub, sig, timestamp+1, appdata) {
-		t.Error("expected invalid signature with wrong timestamp")
-	}
-
-	// Wrong length pubkey → false
-	if sigvalidate.ValidateAdvertSignature([]byte{0xAA, 0xBB}, sig, timestamp, appdata) {
-		t.Error("expected false for short pubkey")
-	}
-
-	// Wrong length signature → false
-	if sigvalidate.ValidateAdvertSignature(pub, []byte{0xAA, 0xBB}, timestamp, appdata) {
-		t.Error("expected false for short signature")
-	}
-}
-
-func TestDecodeAdvertWithSignatureValidation(t *testing.T) {
-	// Generate key pair
-	pub, priv, err := ed25519.GenerateKey(nil)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var timestamp uint32 = 1000000
-	appdata := []byte{0x02} // repeater type, no location
-
-	// Build signed message
-	message := make([]byte, 32+4+len(appdata))
-	copy(message[0:32], pub)
-	binary.LittleEndian.PutUint32(message[32:36], timestamp)
-	copy(message[36:], appdata)
-	sig := ed25519.Sign(priv, message)
-
-	// Build advert buffer: pubkey(32) + timestamp(4) + signature(64) + appdata
-	buf := make([]byte, 0, 101)
-	buf = append(buf, pub...)
-	ts := make([]byte, 4)
-	binary.LittleEndian.PutUint32(ts, timestamp)
-	buf = append(buf, ts...)
-	buf = append(buf, sig...)
-	buf = append(buf, appdata...)
-
-	// With validation enabled
-	p := decodeAdvert(buf, true)
-	if p.Error != "" {
-		t.Fatalf("decode error: %s", p.Error)
-	}
-	if p.SignatureValid == nil {
-		t.Fatal("SignatureValid should be set when validation enabled")
-	}
-	if !*p.SignatureValid {
-		t.Error("expected valid signature")
-	}
-
-	// Without validation
-	p2 := decodeAdvert(buf, false)
-	if p2.SignatureValid != nil {
-		t.Error("SignatureValid should be nil when validation disabled")
-	}
-}

cmd/ingestor/go.mod

@@ -5,14 +5,11 @@ go 1.22
 require (
 	github.com/eclipse/paho.mqtt.golang v1.5.0
 	github.com/meshcore-analyzer/geofilter v0.0.0
-	github.com/meshcore-analyzer/sigvalidate v0.0.0-00010101000000-000000000000
 	modernc.org/sqlite v1.34.5
 )
 
 replace github.com/meshcore-analyzer/geofilter => ../../internal/geofilter
 
-replace github.com/meshcore-analyzer/sigvalidate => ../../internal/sigvalidate
-
 require (
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/google/uuid v1.6.0 // indirect

cmd/ingestor/main.go

@@ -49,6 +49,9 @@ func main() {
 	}
 
 	sources := cfg.ResolvedSources()
+	if len(sources) == 0 {
+		log.Fatal("no MQTT sources configured — set mqttSources in config or MQTT_BROKER env var")
+	}
 
 	store, err := OpenStoreWithInterval(cfg.DBPath, cfg.MetricsSampleInterval())
 	if err != nil {
@@ -160,7 +163,7 @@ func main() {
 	}
 
 	if len(clients) == 0 {
-		log.Fatal("no MQTT connections established — check broker is running (default: mqtt://localhost:1883). Set MQTT_BROKER env var or configure mqttSources in config.json")
+		log.Fatal("no MQTT connections established")
 	}
 
 	log.Printf("Running — %d MQTT source(s) connected", len(clients))
@@ -248,7 +251,7 @@ func handleMessage(store *Store, tag string, source MQTTSource, m mqtt.Message,
 	// Format 1: Raw packet (meshcoretomqtt / Cisien format)
 	rawHex, _ := msg["raw"].(string)
 	if rawHex != "" {
-		decoded, err := DecodePacket(rawHex, channelKeys, false)
+		decoded, err := DecodePacket(rawHex, channelKeys)
 		if err != nil {
 			log.Printf("MQTT [%s] decode error: %v", tag, err)
 			return

cmd/server/apikey_security_test.go

@@ -1,111 +0,0 @@
-package main
-
-import (
-	"net/http"
-	"net/http/httptest"
-	"testing"
-)
-
-func TestIsWeakAPIKey(t *testing.T) {
-	// Known defaults must be detected
-	for _, weak := range []string{
-		"your-secret-api-key-here", "change-me", "example", "test",
-		"password", "admin", "apikey", "api-key", "secret", "default",
-	} {
-		if !IsWeakAPIKey(weak) {
-			t.Errorf("expected %q to be weak", weak)
-		}
-	}
-	// Case-insensitive
-	if !IsWeakAPIKey("Password") {
-		t.Error("expected case-insensitive match for Password")
-	}
-	if !IsWeakAPIKey("YOUR-SECRET-API-KEY-HERE") {
-		t.Error("expected case-insensitive match")
-	}
-
-	// Short keys (<16 chars) are weak
-	if !IsWeakAPIKey("short") {
-		t.Error("expected short key to be weak")
-	}
-	if !IsWeakAPIKey("exactly15chars!") { // 15 chars
-		t.Error("expected 15-char key to be weak")
-	}
-
-	// Empty key is NOT weak (handled separately as "disabled")
-	if IsWeakAPIKey("") {
-		t.Error("empty key should not be flagged as weak")
-	}
-
-	// Strong keys pass
-	if IsWeakAPIKey("a-very-strong-key-1234") {
-		t.Error("expected strong key to pass")
-	}
-	if IsWeakAPIKey("xK9!mP2@nL5#qR8$") {
-		t.Error("expected 17-char random key to pass")
-	}
-}
-
-func TestRequireAPIKey_RejectsWeakKey(t *testing.T) {
-	s := &Server{cfg: &Config{APIKey: "test"}}
-	handler := s.requireAPIKey(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	}))
-
-	req := httptest.NewRequest("POST", "/api/packets", nil)
-	req.Header.Set("X-API-Key", "test")
-	rr := httptest.NewRecorder()
-	handler.ServeHTTP(rr, req)
-
-	if rr.Code != http.StatusForbidden {
-		t.Errorf("expected 403 for weak key, got %d", rr.Code)
-	}
-}
-
-func TestRequireAPIKey_AcceptsStrongKey(t *testing.T) {
-	strongKey := "a-very-strong-key-1234"
-	s := &Server{cfg: &Config{APIKey: strongKey}}
-	handler := s.requireAPIKey(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	}))
-
-	req := httptest.NewRequest("POST", "/api/packets", nil)
-	req.Header.Set("X-API-Key", strongKey)
-	rr := httptest.NewRecorder()
-	handler.ServeHTTP(rr, req)
-
-	if rr.Code != http.StatusOK {
-		t.Errorf("expected 200 for strong key, got %d", rr.Code)
-	}
-}
-
-func TestRequireAPIKey_EmptyKeyDisablesEndpoints(t *testing.T) {
-	s := &Server{cfg: &Config{APIKey: ""}}
-	handler := s.requireAPIKey(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	}))
-
-	req := httptest.NewRequest("POST", "/api/packets", nil)
-	rr := httptest.NewRecorder()
-	handler.ServeHTTP(rr, req)
-
-	if rr.Code != http.StatusForbidden {
-		t.Errorf("expected 403 for empty key, got %d", rr.Code)
-	}
-}
-
-func TestRequireAPIKey_WrongKeyUnauthorized(t *testing.T) {
-	s := &Server{cfg: &Config{APIKey: "a-very-strong-key-1234"}}
-	handler := s.requireAPIKey(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(http.StatusOK)
-	}))
-
-	req := httptest.NewRequest("POST", "/api/packets", nil)
-	req.Header.Set("X-API-Key", "wrong-key-entirely-here")
-	rr := httptest.NewRecorder()
-	handler.ServeHTTP(rr, req)
-
-	if rr.Code != http.StatusUnauthorized {
-		t.Errorf("expected 401 for wrong key, got %d", rr.Code)
-	}
-}

cmd/server/backfill_async_test.go

@@ -1,132 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"net/http"
-	"net/http/httptest"
-	"testing"
-	"time"
-
-	"github.com/gorilla/mux"
-)
-
-// TestBackfillAsyncChunked verifies that backfillResolvedPathsAsync processes
-// observations in chunks, yields between batches, and sets the completion flag.
-func TestBackfillAsyncChunked(t *testing.T) {
-	store := &PacketStore{
-		packets:  make([]*StoreTx, 0),
-		byHash:   make(map[string]*StoreTx),
-		byTxID:   make(map[int]*StoreTx),
-		byObsID:  make(map[int]*StoreObs),
-	}
-
-	// No pending observations → should complete immediately.
-	backfillResolvedPathsAsync(store, "", 100, time.Millisecond, 24)
-	if !store.backfillComplete.Load() {
-		t.Fatal("expected backfillComplete to be true with empty store")
-	}
-}
-
-// TestBackfillStatusHeader verifies the X-CoreScope-Status header is set correctly.
-func TestBackfillStatusHeader(t *testing.T) {
-	store := &PacketStore{
-		packets: make([]*StoreTx, 0),
-		byHash:  make(map[string]*StoreTx),
-		byTxID:  make(map[int]*StoreTx),
-		byObsID: make(map[int]*StoreObs),
-	}
-
-	srv := &Server{store: store}
-
-	handler := srv.backfillStatusMiddleware(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		w.WriteHeader(200)
-	}))
-
-	// Before backfill completes → backfilling
-	req := httptest.NewRequest("GET", "/api/stats", nil)
-	rec := httptest.NewRecorder()
-	handler.ServeHTTP(rec, req)
-	if got := rec.Header().Get("X-CoreScope-Status"); got != "backfilling" {
-		t.Fatalf("expected 'backfilling', got %q", got)
-	}
-
-	// After backfill completes → ready
-	store.backfillComplete.Store(true)
-	rec = httptest.NewRecorder()
-	handler.ServeHTTP(rec, req)
-	if got := rec.Header().Get("X-CoreScope-Status"); got != "ready" {
-		t.Fatalf("expected 'ready', got %q", got)
-	}
-}
-
-// TestStatsBackfillFields verifies /api/stats includes backfill fields.
-func TestStatsBackfillFields(t *testing.T) {
-	db := setupTestDBv2(t)
-	defer db.Close()
-	seedV2Data(t, db)
-
-	store := &PacketStore{
-		db:      db,
-		packets: make([]*StoreTx, 0),
-		byHash:  make(map[string]*StoreTx),
-		byTxID:  make(map[int]*StoreTx),
-		byObsID: make(map[int]*StoreObs),
-		loaded:  true,
-	}
-
-	cfg := &Config{Port: 0}
-	hub := NewHub()
-	srv := NewServer(db, cfg, hub)
-	srv.store = store
-
-	router := mux.NewRouter()
-	srv.RegisterRoutes(router)
-
-	// While backfilling
-	req := httptest.NewRequest("GET", "/api/stats", nil)
-	rec := httptest.NewRecorder()
-	router.ServeHTTP(rec, req)
-
-	var resp map[string]interface{}
-	if err := json.Unmarshal(rec.Body.Bytes(), &resp); err != nil {
-		t.Fatalf("failed to parse stats response: %v", err)
-	}
-
-	if backfilling, ok := resp["backfilling"]; !ok {
-		t.Fatal("missing 'backfilling' field in stats response")
-	} else if backfilling != true {
-		t.Fatalf("expected backfilling=true, got %v", backfilling)
-	}
-
-	if _, ok := resp["backfillProgress"]; !ok {
-		t.Fatal("missing 'backfillProgress' field in stats response")
-	}
-
-	// Check header
-	if got := rec.Header().Get("X-CoreScope-Status"); got != "backfilling" {
-		t.Fatalf("expected X-CoreScope-Status=backfilling, got %q", got)
-	}
-
-	// After backfill completes
-	store.backfillComplete.Store(true)
-	// Invalidate stats cache
-	srv.statsMu.Lock()
-	srv.statsCache = nil
-	srv.statsMu.Unlock()
-
-	rec = httptest.NewRecorder()
-	router.ServeHTTP(rec, req)
-
-	resp = nil
-	if err := json.Unmarshal(rec.Body.Bytes(), &resp); err != nil {
-		t.Fatalf("failed to parse stats response: %v", err)
-	}
-
-	if backfilling, ok := resp["backfilling"]; !ok || backfilling != false {
-		t.Fatalf("expected backfilling=false after completion, got %v", backfilling)
-	}
-
-	if got := rec.Header().Get("X-CoreScope-Status"); got != "ready" {
-		t.Fatalf("expected X-CoreScope-Status=ready, got %q", got)
-	}
-}

cmd/server/config.go

@@ -57,47 +57,6 @@ type Config struct {
 	Timestamps *TimestampConfig `json:"timestamps,omitempty"`
 
 	DebugAffinity bool `json:"debugAffinity,omitempty"`
-
-	ResolvedPath  *ResolvedPathConfig  `json:"resolvedPath,omitempty"`
-	NeighborGraph *NeighborGraphConfig `json:"neighborGraph,omitempty"`
-}
-
-// weakAPIKeys is the blocklist of known default/example API keys that must be rejected.
-var weakAPIKeys = map[string]bool{
-	"your-secret-api-key-here": true,
-	"change-me":                true,
-	"example":                  true,
-	"test":                     true,
-	"password":                 true,
-	"admin":                    true,
-	"apikey":                   true,
-	"api-key":                  true,
-	"secret":                   true,
-	"default":                  true,
-}
-
-// IsWeakAPIKey returns true if the key is in the blocklist or shorter than 16 characters.
-func IsWeakAPIKey(key string) bool {
-	if key == "" {
-		return false // empty is handled separately (endpoints disabled)
-	}
-	if weakAPIKeys[strings.ToLower(key)] {
-		return true
-	}
-	if len(key) < 16 {
-		return true
-	}
-	return false
-}
-
-// ResolvedPathConfig controls async backfill behavior.
-type ResolvedPathConfig struct {
-	BackfillHours int `json:"backfillHours"` // how far back (hours) to scan for NULL resolved_path (default 24)
-}
-
-// NeighborGraphConfig controls neighbor edge pruning.
-type NeighborGraphConfig struct {
-	MaxAgeDays int `json:"maxAgeDays"` // edges older than this are pruned (default 5)
 }
 
 // PacketStoreConfig controls in-memory packet store limits.
@@ -123,21 +82,6 @@ func (c *Config) MetricsRetentionDays() int {
 	return 30
 }
 
-// BackfillHours returns configured backfill window or 24h default.
-func (c *Config) BackfillHours() int {
-	if c.ResolvedPath != nil && c.ResolvedPath.BackfillHours > 0 {
-		return c.ResolvedPath.BackfillHours
-	}
-	return 24
-}
-
-// NeighborMaxAgeDays returns configured max edge age or 30 days default.
-func (c *Config) NeighborMaxAgeDays() int {
-	if c.NeighborGraph != nil && c.NeighborGraph.MaxAgeDays > 0 {
-		return c.NeighborGraph.MaxAgeDays
-	}
-	return 5
-}
 
 type TimestampConfig struct {
 	DefaultMode       string `json:"defaultMode"`       // "ago" | "absolute"

cmd/server/config_knobs_test.go

@@ -1,177 +0,0 @@
-package main
-
-import (
-	"database/sql"
-	"path/filepath"
-	"testing"
-	"time"
-
-	_ "modernc.org/sqlite"
-)
-
-func TestBackfillHoursDefault(t *testing.T) {
-	cfg := &Config{}
-	if got := cfg.BackfillHours(); got != 24 {
-		t.Errorf("BackfillHours() = %d, want 24", got)
-	}
-}
-
-func TestBackfillHoursConfigured(t *testing.T) {
-	cfg := &Config{ResolvedPath: &ResolvedPathConfig{BackfillHours: 48}}
-	if got := cfg.BackfillHours(); got != 48 {
-		t.Errorf("BackfillHours() = %d, want 48", got)
-	}
-}
-
-func TestBackfillHoursZeroFallsBack(t *testing.T) {
-	cfg := &Config{ResolvedPath: &ResolvedPathConfig{BackfillHours: 0}}
-	if got := cfg.BackfillHours(); got != 24 {
-		t.Errorf("BackfillHours() = %d, want 24 (default for zero)", got)
-	}
-}
-
-func TestNeighborMaxAgeDaysDefault(t *testing.T) {
-	cfg := &Config{}
-	if got := cfg.NeighborMaxAgeDays(); got != 5 {
-		t.Errorf("NeighborMaxAgeDays() = %d, want 5", got)
-	}
-}
-
-func TestNeighborMaxAgeDaysConfigured(t *testing.T) {
-	cfg := &Config{NeighborGraph: &NeighborGraphConfig{MaxAgeDays: 7}}
-	if got := cfg.NeighborMaxAgeDays(); got != 7 {
-		t.Errorf("NeighborMaxAgeDays() = %d, want 7", got)
-	}
-}
-
-func TestGraphPruneOlderThan(t *testing.T) {
-	g := NewNeighborGraph()
-	now := time.Now().UTC()
-
-	// Add a recent edge
-	g.upsertEdge("aaa", "bbb", "bb", "obs1", nil, now)
-	// Add an old edge
-	g.upsertEdge("ccc", "ddd", "dd", "obs1", nil, now.Add(-60*24*time.Hour))
-
-	if len(g.AllEdges()) != 2 {
-		t.Fatalf("expected 2 edges, got %d", len(g.AllEdges()))
-	}
-
-	cutoff := now.Add(-30 * 24 * time.Hour)
-	pruned := g.PruneOlderThan(cutoff)
-	if pruned != 1 {
-		t.Errorf("PruneOlderThan pruned %d, want 1", pruned)
-	}
-
-	edges := g.AllEdges()
-	if len(edges) != 1 {
-		t.Fatalf("expected 1 edge after prune, got %d", len(edges))
-	}
-	if edges[0].NodeA != "aaa" && edges[0].NodeB != "aaa" {
-		t.Errorf("wrong edge survived prune: %+v", edges[0])
-	}
-}
-
-func TestPruneNeighborEdgesDB(t *testing.T) {
-	tmpDir := t.TempDir()
-	dbPath := filepath.Join(tmpDir, "test.db")
-	db, err := sql.Open("sqlite", "file:"+dbPath+"?_journal_mode=WAL")
-	if err != nil {
-		t.Fatal(err)
-	}
-	defer db.Close()
-
-	_, err = db.Exec(`CREATE TABLE neighbor_edges (
-		node_a TEXT NOT NULL,
-		node_b TEXT NOT NULL,
-		count INTEGER DEFAULT 1,
-		last_seen TEXT,
-		PRIMARY KEY (node_a, node_b)
-	)`)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	now := time.Now().UTC()
-	old := now.Add(-60 * 24 * time.Hour)
-
-	db.Exec("INSERT INTO neighbor_edges (node_a, node_b, count, last_seen) VALUES (?, ?, 5, ?)",
-		"aaa", "bbb", now.Format(time.RFC3339))
-	db.Exec("INSERT INTO neighbor_edges (node_a, node_b, count, last_seen) VALUES (?, ?, 3, ?)",
-		"ccc", "ddd", old.Format(time.RFC3339))
-
-	g := NewNeighborGraph()
-	g.upsertEdge("aaa", "bbb", "bb", "obs1", nil, now)
-	g.upsertEdge("ccc", "ddd", "dd", "obs1", nil, old)
-
-	pruned, err := PruneNeighborEdges(dbPath, g, 30)
-	if err != nil {
-		t.Fatal(err)
-	}
-	if pruned != 1 {
-		t.Errorf("PruneNeighborEdges pruned %d DB rows, want 1", pruned)
-	}
-
-	var count int
-	db.QueryRow("SELECT COUNT(*) FROM neighbor_edges").Scan(&count)
-	if count != 1 {
-		t.Errorf("expected 1 row in DB after prune, got %d", count)
-	}
-
-	if len(g.AllEdges()) != 1 {
-		t.Errorf("expected 1 in-memory edge after prune, got %d", len(g.AllEdges()))
-	}
-}
-
-func TestBackfillRespectsHourWindow(t *testing.T) {
-	store := &PacketStore{}
-
-	now := time.Now().UTC()
-	oldTime := now.Add(-48 * time.Hour).Format(time.RFC3339Nano)
-	newTime := now.Add(-30 * time.Minute).Format(time.RFC3339Nano)
-
-	store.packets = []*StoreTx{
-		{
-			ID:        1,
-			Hash:      "old-hash",
-			FirstSeen: oldTime,
-			Observations: []*StoreObs{
-				{ID: 1, PathJSON: `["abc"]`},
-			},
-		},
-		{
-			ID:        2,
-			Hash:      "new-hash",
-			FirstSeen: newTime,
-			Observations: []*StoreObs{
-				{ID: 2, PathJSON: `["def"]`},
-			},
-		},
-	}
-
-	// With a 1-hour window, only the new tx should be processed.
-	// backfillResolvedPathsAsync will find no prefix map and finish quickly,
-	// but we can verify the pending count reflects the window.
-	go backfillResolvedPathsAsync(store, "", 100, time.Millisecond, 1)
-
-	// Wait for completion
-	for i := 0; i < 100; i++ {
-		if store.backfillComplete.Load() {
-			break
-		}
-		time.Sleep(10 * time.Millisecond)
-	}
-
-	if !store.backfillComplete.Load() {
-		t.Fatal("backfill did not complete")
-	}
-
-	// With no prefix map, total should be 0 (early exit) or just the new one
-	// The function exits early when pm == nil, so backfillTotal stays at 0
-	// if there were pending items but no pm. Let's verify it didn't process
-	// the old one by checking total <= 1.
-	total := store.backfillTotal.Load()
-	if total > 1 {
-		t.Errorf("backfill total = %d, want <= 1 (old tx should be excluded by hour window)", total)
-	}
-}

cmd/server/coverage_test.go

@@ -2198,53 +2198,6 @@ func TestStoreGetAnalyticsHashSizes(t *testing.T) {
 	})
 }
 
-func TestHashSizesDistributionByRepeatersFiltersRole(t *testing.T) {
-	db := setupRichTestDB(t)
-	defer db.Close()
-	store := NewPacketStore(db, nil)
-	store.Load()
-
-	result := store.GetAnalyticsHashSizes("")
-
-	// distributionByRepeaters should only count repeater nodes.
-	// Rich test DB: aabbccdd11223344 = repeater (hash size 2), eeff00112233aabb = companion (hash size 3).
-	dbr, ok := result["distributionByRepeaters"].(map[string]int)
-	if !ok {
-		t.Fatal("expected distributionByRepeaters map")
-	}
-	// Only the repeater node should be counted.
-	if dbr["3"] != 0 {
-		t.Errorf("distributionByRepeaters[3] = %d, want 0 (companion should be excluded)", dbr["3"])
-	}
-	if dbr["2"] != 1 {
-		t.Errorf("distributionByRepeaters[2] = %d, want 1 (repeater)", dbr["2"])
-	}
-
-	// multiByteNodes should include role field for frontend filtering.
-	mbn, ok := result["multiByteNodes"].([]map[string]interface{})
-	if !ok {
-		t.Fatal("expected multiByteNodes slice")
-	}
-	for _, node := range mbn {
-		if _, hasRole := node["role"]; !hasRole {
-			t.Errorf("multiByteNodes entry missing 'role' field: %v", node)
-		}
-	}
-	// Verify companion is included in multiByteNodes (it's multi-byte) with correct role.
-	foundCompanion := false
-	for _, node := range mbn {
-		if node["pubkey"] == "eeff00112233aabb" {
-			foundCompanion = true
-			if node["role"] != "companion" {
-				t.Errorf("companion node role = %v, want 'companion'", node["role"])
-			}
-		}
-	}
-	if !foundCompanion {
-		t.Error("expected companion node in multiByteNodes (multi-byte adopters should include all roles)")
-	}
-}
-
 func TestStoreGetAnalyticsSubpaths(t *testing.T) {
 	db := setupRichTestDB(t)
 	defer db.Close()

cmd/server/db_test.go

@@ -72,8 +72,7 @@ func setupTestDB(t *testing.T) *DB {
 			rssi REAL,
 			score INTEGER,
 			path_json TEXT,
-			timestamp INTEGER NOT NULL,
-			resolved_path TEXT
+			timestamp INTEGER NOT NULL
 		);
 
 		CREATE TABLE IF NOT EXISTS observer_metrics (
@@ -96,7 +95,7 @@ func setupTestDB(t *testing.T) *DB {
 		t.Fatal(err)
 	}
 
-	return &DB{conn: conn, isV3: true, hasResolvedPath: true}
+	return &DB{conn: conn, isV3: true}
 }
 
 func seedTestData(t *testing.T, db *DB) {
@@ -133,15 +132,14 @@ func seedTestData(t *testing.T, db *DB) {
 		VALUES ('AA1F', 'def456abc1230099', ?, 1, 4, '{"pubKey":"aabbccdd11223344","name":"TestRepeater","type":"ADVERT","timestamp":1700000100,"timestampISO":"2023-11-14T22:14:40.000Z","signature":"fedcba","flags":{"isRepeater":true},"lat":37.5,"lon":-122.0}')`, yesterday)
 
 	// Seed observations (use unix timestamps)
-	// resolved_path contains full pubkeys parallel to path_json hops
-	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp, resolved_path)
-		VALUES (1, 1, 12.5, -90, '["aa","bb"]', ?, '["aabbccdd11223344","eeff00112233aabb"]')`, recentEpoch)
-	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp, resolved_path)
-		VALUES (1, 2, 8.0, -95, '["aa"]', ?, '["aabbccdd11223344"]')`, recentEpoch-100)
+	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp)
+		VALUES (1, 1, 12.5, -90, '["aa","bb"]', ?)`, recentEpoch)
+	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp)
+		VALUES (1, 2, 8.0, -95, '["aa"]', ?)`, recentEpoch-100)
 	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp)
 		VALUES (2, 1, 15.0, -85, '[]', ?)`, yesterdayEpoch)
-	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp, resolved_path)
-		VALUES (3, 1, 10.0, -92, '["cc"]', ?, '["1122334455667788"]')`, yesterdayEpoch)
+	db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp)
+		VALUES (3, 1, 10.0, -92, '["cc"]', ?)`, yesterdayEpoch)
 }
 
 func TestGetStats(t *testing.T) {

cmd/server/decoder.go

@@ -9,8 +9,6 @@ import (
 	"math"
 	"strings"
 	"time"
-
-	"github.com/meshcore-analyzer/sigvalidate"
 )
 
 // Route type constants (header bits 1-0)
@@ -62,10 +60,9 @@ type TransportCodes struct {
 
 // Path holds decoded path/hop information.
 type Path struct {
-	HashSize      int      `json:"hashSize"`
-	HashCount     int      `json:"hashCount"`
-	Hops          []string `json:"hops"`
-	HopsCompleted *int     `json:"hopsCompleted,omitempty"`
+	HashSize  int      `json:"hashSize"`
+	HashCount int      `json:"hashCount"`
+	Hops      []string `json:"hops"`
 }
 
 // AdvertFlags holds decoded advert flag bits.
@@ -94,7 +91,6 @@ type Payload struct {
 	Timestamp       uint32       `json:"timestamp,omitempty"`
 	TimestampISO    string       `json:"timestampISO,omitempty"`
 	Signature       string       `json:"signature,omitempty"`
-	SignatureValid  *bool        `json:"signatureValid,omitempty"`
 	Flags           *AdvertFlags `json:"flags,omitempty"`
 	Lat             *float64     `json:"lat,omitempty"`
 	Lon             *float64     `json:"lon,omitempty"`
@@ -191,7 +187,7 @@ func decodeAck(buf []byte) Payload {
 	}
 }
 
-func decodeAdvert(buf []byte, validateSignatures bool) Payload {
+func decodeAdvert(buf []byte) Payload {
 	if len(buf) < 100 {
 		return Payload{Type: "ADVERT", Error: "too short for advert", RawHex: hex.EncodeToString(buf)}
 	}
@@ -209,11 +205,6 @@ func decodeAdvert(buf []byte, validateSignatures bool) Payload {
 		Signature:    signature,
 	}
 
-	if validateSignatures {
-		valid := sigvalidate.ValidateAdvertSignature(buf[0:32], buf[36:100], timestamp, appdata)
-		p.SignatureValid = &valid
-	}
-
 	if len(appdata) > 0 {
 		flags := appdata[0]
 		advType := int(flags & 0x0F)
@@ -316,7 +307,7 @@ func decodeTrace(buf []byte) Payload {
 	return p
 }
 
-func decodePayload(payloadType int, buf []byte, validateSignatures bool) Payload {
+func decodePayload(payloadType int, buf []byte) Payload {
 	switch payloadType {
 	case PayloadREQ:
 		return decodeEncryptedPayload("REQ", buf)
@@ -327,7 +318,7 @@ func decodePayload(payloadType int, buf []byte, validateSignatures bool) Payload
 	case PayloadACK:
 		return decodeAck(buf)
 	case PayloadADVERT:
-		return decodeAdvert(buf, validateSignatures)
+		return decodeAdvert(buf)
 	case PayloadGRP_TXT:
 		return decodeGrpTxt(buf)
 	case PayloadANON_REQ:
@@ -342,7 +333,7 @@ func decodePayload(payloadType int, buf []byte, validateSignatures bool) Payload
 }
 
 // DecodePacket decodes a hex-encoded MeshCore packet.
-func DecodePacket(hexString string, validateSignatures bool) (*DecodedPacket, error) {
+func DecodePacket(hexString string) (*DecodedPacket, error) {
 	hexString = strings.ReplaceAll(hexString, " ", "")
 	hexString = strings.ReplaceAll(hexString, "\n", "")
 	hexString = strings.ReplaceAll(hexString, "\r", "")
@@ -380,17 +371,12 @@ func DecodePacket(hexString string, validateSignatures bool) (*DecodedPacket, er
 	offset += bytesConsumed
 
 	payloadBuf := buf[offset:]
-	payload := decodePayload(header.PayloadType, payloadBuf, validateSignatures)
+	payload := decodePayload(header.PayloadType, payloadBuf)
 
 	// TRACE packets store hop IDs in the payload (buf[9:]) rather than the header
 	// path field. The header path byte still encodes hashSize in bits 6-7, which
 	// we use to split the payload path data into individual hop prefixes.
-	// The header path contains SNR bytes — one per hop that actually forwarded.
-	// We expose hopsCompleted (count of SNR bytes) so consumers can distinguish
-	// how far the trace got vs the full intended route.
 	if header.PayloadType == PayloadTRACE && payload.PathData != "" {
-		// The header path hops count represents SNR entries = completed hops
-		hopsCompleted := path.HashCount
 		pathBytes, err := hex.DecodeString(payload.PathData)
 		if err == nil && path.HashSize > 0 {
 			hops := make([]string, 0, len(pathBytes)/path.HashSize)
@@ -399,20 +385,9 @@ func DecodePacket(hexString string, validateSignatures bool) (*DecodedPacket, er
 			}
 			path.Hops = hops
 			path.HashCount = len(hops)
-			path.HopsCompleted = &hopsCompleted
 		}
 	}
 
-	// Zero-hop direct packets have hash_count=0 (lower 6 bits of pathByte),
-	// which makes the generic formula yield a bogus hashSize. Reset to 0
-	// (unknown) so API consumers get correct data. We mask with 0x3F to check
-	// only hash_count, matching the JS frontend approach — the upper hash_size
-	// bits are meaningless when there are no hops. Skip TRACE packets — they
-	// use hashSize to parse hops from the payload above.
-	if (header.RouteType == RouteDirect || header.RouteType == RouteTransportDirect) && pathByte&0x3F == 0 && header.PayloadType != PayloadTRACE {
-		path.HashSize = 0
-	}
-
 	return &DecodedPacket{
 		Header:         header,
 		TransportCodes: tc,

cmd/server/decoder_test.go

@@ -1,11 +1,7 @@
 package main
 
 import (
-	"crypto/ed25519"
-	"encoding/binary"
 	"testing"
-
-	"github.com/meshcore-analyzer/sigvalidate"
 )
 
 func TestDecodeHeader_TransportFlood(t *testing.T) {
@@ -69,7 +65,7 @@ func TestDecodePacket_TransportFloodHasCodes(t *testing.T) {
 	// Path byte: 0x00 (hashSize=1, hashCount=0)
 	// Payload: at least some bytes for GRP_TXT
 	hex := "14AABBCCDD00112233445566778899"
-	pkt, err := DecodePacket(hex, false)
+	pkt, err := DecodePacket(hex)
 	if err != nil {
 		t.Fatalf("unexpected error: %v", err)
 	}
@@ -89,7 +85,7 @@ func TestDecodePacket_FloodHasNoCodes(t *testing.T) {
 	// Path byte: 0x00 (no hops)
 	// Some payload bytes
 	hex := "110011223344556677889900AABBCCDD"
-	pkt, err := DecodePacket(hex, false)
+	pkt, err := DecodePacket(hex)
 	if err != nil {
 		t.Fatalf("unexpected error: %v", err)
 	}
@@ -239,87 +235,6 @@ func assertRange(t *testing.T, ranges []HexRange, label string, wantStart, wantE
 	t.Errorf("range %q not found in %v", label, rangeLabels(ranges))
 }
 
-func TestZeroHopDirectHashSize(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x00 → hash_count=0, hash_size bits=0 → should get HashSize=0
-	// Need at least a few payload bytes after pathByte.
-	hex := "02" + "00" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("DIRECT zero-hop: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestZeroHopDirectHashSizeWithNonZeroUpperBits(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x40 → hash_count=0, hash_size bits=01 → should still get HashSize=0
-	// because hash_count is zero (lower 6 bits are 0).
-	hex := "02" + "40" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("DIRECT zero-hop with hash_size bits set: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestZeroHopTransportDirectHashSize(t *testing.T) {
-	// TRANSPORT_DIRECT (RouteType=3) + REQ (PayloadType=0) → header byte = 0x03
-	// 4 bytes transport codes + pathByte=0x00 → hash_count=0 → should get HashSize=0
-	hex := "03" + "11223344" + "00" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("TRANSPORT_DIRECT zero-hop: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestZeroHopTransportDirectHashSizeWithNonZeroUpperBits(t *testing.T) {
-	// TRANSPORT_DIRECT (RouteType=3) + REQ (PayloadType=0) → header byte = 0x03
-	// 4 bytes transport codes + pathByte=0xC0 → hash_count=0, hash_size bits=11 → should still get HashSize=0
-	hex := "03" + "11223344" + "C0" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 0 {
-		t.Errorf("TRANSPORT_DIRECT zero-hop with hash_size bits set: want HashSize=0, got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestNonDirectZeroPathByteKeepsHashSize(t *testing.T) {
-	// FLOOD (RouteType=1) + REQ (PayloadType=0) → header byte = 0x01
-	// pathByte=0x00 → even though hash_count=0, non-DIRECT should keep HashSize=1
-	hex := "01" + "00" + repeatHex("AA", 20)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 1 {
-		t.Errorf("FLOOD zero pathByte: want HashSize=1 (unchanged), got %d", pkt.Path.HashSize)
-	}
-}
-
-func TestDirectNonZeroHopKeepsHashSize(t *testing.T) {
-	// DIRECT (RouteType=2) + REQ (PayloadType=0) → header byte = 0x02
-	// pathByte=0x01 → hash_count=1, hash_size=1 → should keep HashSize=1
-	// Need 1 hop hash byte after pathByte.
-	hex := "02" + "01" + repeatHex("BB", 21)
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket failed: %v", err)
-	}
-	if pkt.Path.HashSize != 1 {
-		t.Errorf("DIRECT with 1 hop: want HashSize=1, got %d", pkt.Path.HashSize)
-	}
-}
-
 func repeatHex(byteHex string, n int) string {
 	s := ""
 	for i := 0; i < n; i++ {
@@ -327,168 +242,3 @@ func repeatHex(byteHex string, n int) string {
 	}
 	return s
 }
-
-func TestDecodePacket_TraceHopsCompleted(t *testing.T) {
-	// Build a TRACE packet:
-	// header: route=FLOOD(1), payload=TRACE(9), version=0 → (0<<6)|(9<<2)|1 = 0x25
-	// path_length: hash_size bits=0b00 (1-byte), hash_count=2 (2 SNR bytes) → 0x02
-	// path: 2 SNR bytes: 0xAA, 0xBB
-	// payload: tag(4 LE) + authCode(4 LE) + flags(1) + 4 hop hashes (1 byte each)
-	hex := "2502AABB" + // header + path_length + 2 SNR bytes
-		"01000000" + // tag = 1
-		"02000000" + // authCode = 2
-		"00" + // flags = 0
-		"DEADBEEF" // 4 hops (1-byte hash each)
-
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket error: %v", err)
-	}
-	if pkt.Payload.Type != "TRACE" {
-		t.Fatalf("expected TRACE, got %s", pkt.Payload.Type)
-	}
-	// Full intended route = 4 hops from payload
-	if len(pkt.Path.Hops) != 4 {
-		t.Errorf("expected 4 hops, got %d: %v", len(pkt.Path.Hops), pkt.Path.Hops)
-	}
-	// HopsCompleted = 2 (from header path SNR count)
-	if pkt.Path.HopsCompleted == nil {
-		t.Fatal("expected HopsCompleted to be set")
-	}
-	if *pkt.Path.HopsCompleted != 2 {
-		t.Errorf("expected HopsCompleted=2, got %d", *pkt.Path.HopsCompleted)
-	}
-}
-
-func TestDecodePacket_TraceNoSNR(t *testing.T) {
-	// TRACE with 0 SNR bytes (trace hasn't been forwarded yet)
-	// path_length: hash_size=0b00 (1-byte), hash_count=0 → 0x00
-	hex := "2500" + // header + path_length (0 hops in header)
-		"01000000" + // tag
-		"02000000" + // authCode
-		"00" + // flags
-		"AABBCC" // 3 hops intended
-
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket error: %v", err)
-	}
-	if pkt.Path.HopsCompleted == nil {
-		t.Fatal("expected HopsCompleted to be set")
-	}
-	if *pkt.Path.HopsCompleted != 0 {
-		t.Errorf("expected HopsCompleted=0, got %d", *pkt.Path.HopsCompleted)
-	}
-	if len(pkt.Path.Hops) != 3 {
-		t.Errorf("expected 3 hops, got %d", len(pkt.Path.Hops))
-	}
-}
-
-func TestDecodePacket_TraceFullyCompleted(t *testing.T) {
-	// TRACE where all hops completed (SNR count = hop count)
-	// path_length: hash_size=0b00 (1-byte), hash_count=3 → 0x03
-	hex := "2503AABBCC" + // header + path_length + 3 SNR bytes
-		"01000000" + // tag
-		"02000000" + // authCode
-		"00" + // flags
-		"DDEEFF" // 3 hops intended
-
-	pkt, err := DecodePacket(hex, false)
-	if err != nil {
-		t.Fatalf("DecodePacket error: %v", err)
-	}
-	if pkt.Path.HopsCompleted == nil {
-		t.Fatal("expected HopsCompleted to be set")
-	}
-	if *pkt.Path.HopsCompleted != 3 {
-		t.Errorf("expected HopsCompleted=3, got %d", *pkt.Path.HopsCompleted)
-	}
-	if len(pkt.Path.Hops) != 3 {
-		t.Errorf("expected 3 hops, got %d", len(pkt.Path.Hops))
-	}
-}
-
-func TestValidateAdvertSignature(t *testing.T) {
-	pub, priv, err := ed25519.GenerateKey(nil)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var timestamp uint32 = 1234567890
-	appdata := []byte{0x02, 0x11, 0x22}
-
-	message := make([]byte, 32+4+len(appdata))
-	copy(message[0:32], pub)
-	binary.LittleEndian.PutUint32(message[32:36], timestamp)
-	copy(message[36:], appdata)
-
-	sig := ed25519.Sign(priv, message)
-
-	// Valid signature
-	if !sigvalidate.ValidateAdvertSignature(pub, sig, timestamp, appdata) {
-		t.Error("expected valid signature")
-	}
-
-	// Tampered appdata
-	if sigvalidate.ValidateAdvertSignature(pub, sig, timestamp, []byte{0x03, 0x11, 0x22}) {
-		t.Error("expected invalid with tampered appdata")
-	}
-
-	// Wrong timestamp
-	if sigvalidate.ValidateAdvertSignature(pub, sig, timestamp+1, appdata) {
-		t.Error("expected invalid with wrong timestamp")
-	}
-
-	// Short pubkey
-	if sigvalidate.ValidateAdvertSignature([]byte{0xAA}, sig, timestamp, appdata) {
-		t.Error("expected false for short pubkey")
-	}
-
-	// Short signature
-	if sigvalidate.ValidateAdvertSignature(pub, []byte{0xBB}, timestamp, appdata) {
-		t.Error("expected false for short signature")
-	}
-}
-
-func TestDecodeAdvertWithSignatureValidation(t *testing.T) {
-	pub, priv, err := ed25519.GenerateKey(nil)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var timestamp uint32 = 1000000
-	appdata := []byte{0x02} // repeater type
-
-	message := make([]byte, 32+4+len(appdata))
-	copy(message[0:32], pub)
-	binary.LittleEndian.PutUint32(message[32:36], timestamp)
-	copy(message[36:], appdata)
-	sig := ed25519.Sign(priv, message)
-
-	// Build advert buffer: pubkey(32) + timestamp(4) + signature(64) + appdata
-	buf := make([]byte, 0, 101)
-	buf = append(buf, pub...)
-	ts := make([]byte, 4)
-	binary.LittleEndian.PutUint32(ts, timestamp)
-	buf = append(buf, ts...)
-	buf = append(buf, sig...)
-	buf = append(buf, appdata...)
-
-	// With validation
-	p := decodeAdvert(buf, true)
-	if p.Error != "" {
-		t.Fatalf("decode error: %s", p.Error)
-	}
-	if p.SignatureValid == nil {
-		t.Fatal("SignatureValid should be set when validation enabled")
-	}
-	if !*p.SignatureValid {
-		t.Error("expected valid signature")
-	}
-
-	// Without validation
-	p2 := decodeAdvert(buf, false)
-	if p2.SignatureValid != nil {
-		t.Error("SignatureValid should be nil when validation disabled")
-	}
-}

cmd/server/eviction_test.go

@@ -276,29 +276,3 @@ func TestNewPacketStoreNilConfig(t *testing.T) {
 		t.Fatalf("expected retentionHours=0, got %f", store.retentionHours)
 	}
 }
-
-func TestCacheTTLFromConfig(t *testing.T) {
-	// With config values: analyticsHashSizes and analyticsRF should override defaults.
-	cacheTTL := map[string]interface{}{
-		"analyticsHashSizes": float64(7200),
-		"analyticsRF":        float64(300),
-	}
-	store := NewPacketStore(nil, nil, cacheTTL)
-	if store.collisionCacheTTL != 7200*time.Second {
-		t.Fatalf("expected collisionCacheTTL=7200s, got %v", store.collisionCacheTTL)
-	}
-	if store.rfCacheTTL != 300*time.Second {
-		t.Fatalf("expected rfCacheTTL=300s, got %v", store.rfCacheTTL)
-	}
-}
-
-func TestCacheTTLDefaults(t *testing.T) {
-	// Without config, defaults should apply.
-	store := NewPacketStore(nil, nil)
-	if store.collisionCacheTTL != 3600*time.Second {
-		t.Fatalf("expected default collisionCacheTTL=3600s, got %v", store.collisionCacheTTL)
-	}
-	if store.rfCacheTTL != 15*time.Second {
-		t.Fatalf("expected default rfCacheTTL=15s, got %v", store.rfCacheTTL)
-	}
-}

cmd/server/go.mod

@@ -6,14 +6,11 @@ require (
 	github.com/gorilla/mux v1.8.1
 	github.com/gorilla/websocket v1.5.3
 	github.com/meshcore-analyzer/geofilter v0.0.0
-	github.com/meshcore-analyzer/sigvalidate v0.0.0-00010101000000-000000000000
 	modernc.org/sqlite v1.34.5
 )
 
 replace github.com/meshcore-analyzer/geofilter => ../../internal/geofilter
 
-replace github.com/meshcore-analyzer/sigvalidate => ../../internal/sigvalidate
-
 require (
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/google/uuid v1.6.0 // indirect

cmd/server/main.go

@@ -104,8 +104,6 @@ func main() {
 	}
 	if cfg.APIKey == "" {
 		log.Printf("[security] WARNING: no apiKey configured — write endpoints are BLOCKED (set apiKey in config.json to enable them)")
-	} else if IsWeakAPIKey(cfg.APIKey) {
-		log.Printf("[security] WARNING: API key is weak or a known default — write endpoints are vulnerable")
 	}
 
 	// Resolve DB path
@@ -141,7 +139,7 @@ func main() {
 	}
 
 	// In-memory packet store
-	store := NewPacketStore(database, cfg.PacketStore, cfg.CacheTTL)
+	store := NewPacketStore(database, cfg.PacketStore)
 	if err := store.Load(); err != nil {
 		log.Fatalf("[store] failed to load: %v", err)
 	}
@@ -155,7 +153,7 @@ func main() {
 	// NOTE on startup ordering (review item #10): ensureResolvedPathColumn runs AFTER
 	// OpenDB/detectSchema, so db.hasResolvedPath will be false on first run with a
 	// pre-existing DB. This means Load() won't SELECT resolved_path from SQLite.
-	// Async backfill runs after HTTP starts (see backfillResolvedPathsAsync below)
+	// That's OK: backfillResolvedPaths (below) computes and persists them in-memory
 	// AND to SQLite. On next restart, detectSchema finds the column and Load() reads it.
 	if err := ensureResolvedPathColumn(dbPath); err != nil {
 		log.Printf("[store] warning: could not add resolved_path column: %v", err)
@@ -168,59 +166,27 @@ func main() {
 		store.graph = loadNeighborEdgesFromDB(database.conn)
 		log.Printf("[neighbor] loaded persisted neighbor graph")
 	} else {
-		log.Printf("[neighbor] no persisted edges found, will build in background...")
-		store.graph = NewNeighborGraph() // empty graph — gets populated by background goroutine
-		go func() {
-			defer func() {
-				if r := recover(); r != nil {
-					log.Printf("[neighbor] graph build panic recovered: %v", r)
-				}
-			}()
-			rw, rwErr := openRW(dbPath)
-			if rwErr == nil {
-				edgeCount := buildAndPersistEdges(store, rw)
-				rw.Close()
-				log.Printf("[neighbor] persisted %d edges", edgeCount)
-			}
-			built := BuildFromStore(store)
-			store.mu.Lock()
-			store.graph = built
-			store.mu.Unlock()
-			log.Printf("[neighbor] graph build complete")
-		}()
+		log.Printf("[neighbor] no persisted edges found, building from store...")
+		rw, rwErr := openRW(dbPath)
+		if rwErr == nil {
+			edgeCount := buildAndPersistEdges(store, rw)
+			rw.Close()
+			log.Printf("[neighbor] persisted %d edges", edgeCount)
+		}
+		store.graph = BuildFromStore(store)
 	}
 
-	// Initial pickBestObservation runs in background — doesn't need to block HTTP.
-	// API serves best-effort data until this completes (~10s for 100K txs).
-	// Processes in chunks of 5000, releasing the lock between chunks so API
-	// handlers remain responsive.
-	go func() {
-		defer func() {
-			if r := recover(); r != nil {
-				log.Printf("[store] pickBestObservation panic recovered: %v", r)
-			}
-		}()
-		const chunkSize = 5000
-		store.mu.RLock()
-		totalPackets := len(store.packets)
-		store.mu.RUnlock()
+	// Backfill resolved_path for observations that don't have it yet
+	if backfilled := backfillResolvedPaths(store, dbPath); backfilled > 0 {
+		log.Printf("[store] backfilled resolved_path for %d observations", backfilled)
+	}
 
-		for i := 0; i < totalPackets; i += chunkSize {
-			end := i + chunkSize
-			if end > totalPackets {
-				end = totalPackets
-			}
-			store.mu.Lock()
-			for j := i; j < end && j < len(store.packets); j++ {
-				pickBestObservation(store.packets[j])
-			}
-			store.mu.Unlock()
-			if end < totalPackets {
-				time.Sleep(10 * time.Millisecond) // yield to API handlers
-			}
-		}
-		log.Printf("[store] initial pickBestObservation complete (%d transmissions)", totalPackets)
-	}()
+	// Re-pick best observation now that resolved paths are populated
+	store.mu.Lock()
+	for _, tx := range store.packets {
+		pickBestObservation(tx)
+	}
+	store.mu.Unlock()
 
 	// WebSocket hub
 	hub := NewHub()
@@ -268,11 +234,6 @@ func main() {
 			close(pruneDone)
 		}
 		go func() {
-			defer func() {
-				if r := recover(); r != nil {
-					log.Printf("[prune] panic recovered: %v", r)
-				}
-			}()
 			time.Sleep(1 * time.Minute)
 			if n, err := database.PruneOldPackets(days); err != nil {
 				log.Printf("[prune] error: %v", err)
@@ -306,11 +267,6 @@ func main() {
 			close(metricsPruneDone)
 		}
 		go func() {
-			defer func() {
-				if r := recover(); r != nil {
-					log.Printf("[metrics-prune] panic recovered: %v", r)
-				}
-			}()
 			time.Sleep(2 * time.Minute) // stagger after packet prune
 			database.PruneOldMetrics(metricsDays)
 			for {
@@ -325,42 +281,6 @@ func main() {
 		log.Printf("[metrics-prune] auto-prune enabled: metrics older than %d days", metricsDays)
 	}
 
-	// Auto-prune old neighbor edges
-	var stopEdgePrune func()
-	{
-		maxAgeDays := cfg.NeighborMaxAgeDays()
-		edgePruneTicker := time.NewTicker(24 * time.Hour)
-		edgePruneDone := make(chan struct{})
-		stopEdgePrune = func() {
-			edgePruneTicker.Stop()
-			close(edgePruneDone)
-		}
-		go func() {
-			defer func() {
-				if r := recover(); r != nil {
-					log.Printf("[neighbor-prune] panic recovered: %v", r)
-				}
-			}()
-			time.Sleep(4 * time.Minute) // stagger after metrics prune
-			store.mu.RLock()
-			g := store.graph
-			store.mu.RUnlock()
-			PruneNeighborEdges(dbPath, g, maxAgeDays)
-			for {
-				select {
-				case <-edgePruneTicker.C:
-					store.mu.RLock()
-					g := store.graph
-					store.mu.RUnlock()
-					PruneNeighborEdges(dbPath, g, maxAgeDays)
-				case <-edgePruneDone:
-					return
-				}
-			}
-		}()
-		log.Printf("[neighbor-prune] auto-prune enabled: edges older than %d days", maxAgeDays)
-	}
-
 	// Graceful shutdown
 	httpServer := &http.Server{
 		Addr:         fmt.Sprintf(":%d", cfg.Port),
@@ -386,9 +306,6 @@ func main() {
 		if stopMetricsPrune != nil {
 			stopMetricsPrune()
 		}
-		if stopEdgePrune != nil {
-			stopEdgePrune()
-		}
 
 		// 2. Gracefully drain HTTP connections (up to 15s)
 		ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
@@ -408,10 +325,6 @@ func main() {
 	}()
 
 	log.Printf("[server] CoreScope (Go) listening on http://localhost:%d", cfg.Port)
-
-	// Start async backfill in background — HTTP is now available.
-	go backfillResolvedPathsAsync(store, dbPath, 5000, 100*time.Millisecond, cfg.BackfillHours())
-
 	if err := httpServer.ListenAndServe(); err != http.ErrServerClosed {
 		log.Fatalf("[server] %v", err)
 	}

cmd/server/neighbor_api.go

@@ -20,20 +20,19 @@ type NeighborResponse struct {
 }
 
 type NeighborEntry struct {
-	Pubkey      *string          `json:"pubkey"`
-	Prefix      string           `json:"prefix"`
-	Name        *string          `json:"name"`
-	Role        *string          `json:"role"`
-	Count       int              `json:"count"`
-	Score       float64          `json:"score"`
-	FirstSeen   string           `json:"first_seen"`
-	LastSeen    string           `json:"last_seen"`
-	AvgSNR      *float64         `json:"avg_snr"`
-	DistanceKm  *float64         `json:"distance_km,omitempty"`
-	Observers   []string         `json:"observers"`
-	Ambiguous   bool             `json:"ambiguous"`
-	Unresolved  bool             `json:"unresolved,omitempty"`
-	Candidates  []CandidateEntry `json:"candidates,omitempty"`
+	Pubkey     *string           `json:"pubkey"`
+	Prefix     string            `json:"prefix"`
+	Name       *string           `json:"name"`
+	Role       *string           `json:"role"`
+	Count      int               `json:"count"`
+	Score      float64           `json:"score"`
+	FirstSeen  string            `json:"first_seen"`
+	LastSeen   string            `json:"last_seen"`
+	AvgSNR     *float64          `json:"avg_snr"`
+	Observers  []string          `json:"observers"`
+	Ambiguous  bool              `json:"ambiguous"`
+	Unresolved bool              `json:"unresolved,omitempty"`
+	Candidates []CandidateEntry  `json:"candidates,omitempty"`
 }
 
 type CandidateEntry struct {
@@ -116,15 +115,9 @@ func (s *Server) handleNodeNeighbors(w http.ResponseWriter, r *http.Request) {
 	edges := graph.Neighbors(pubkey)
 	now := time.Now()
 
-	// Build node info lookup for names/roles/coordinates.
+	// Build node info lookup for names/roles.
 	nodeMap := s.buildNodeInfoMap()
 
-	// Look up the queried node's GPS coordinates for distance computation.
-	var srcInfo nodeInfo
-	if nodeMap != nil {
-		srcInfo = nodeMap[pubkey]
-	}
-
 	var entries []NeighborEntry
 	totalObs := 0
 
@@ -177,10 +170,6 @@ func (s *Server) handleNodeNeighbors(w http.ResponseWriter, r *http.Request) {
 			if info, ok := nodeMap[strings.ToLower(neighborPK)]; ok {
 				entry.Name = &info.Name
 				entry.Role = &info.Role
-				if srcInfo.HasGPS && info.HasGPS {
-					d := haversineKm(srcInfo.Lat, srcInfo.Lon, info.Lat, info.Lon)
-					entry.DistanceKm = &d
-				}
 			}
 		}
 

cmd/server/neighbor_api_test.go

@@ -347,69 +347,6 @@ func TestNeighborGraphAPI_AmbiguousEdgesCount(t *testing.T) {
 	}
 }
 
-func TestNeighborAPI_DistanceKm_WithGPS(t *testing.T) {
-	db := setupTestDB(t)
-	defer db.Close()
-
-	db.conn.Exec(`INSERT INTO nodes (public_key, name, role, lat, lon, last_seen, first_seen)
-		VALUES ('aaaa', 'NodeA', 'repeater', 51.5074, -0.1278, '2026-01-01T00:00:00Z', '2025-01-01T00:00:00Z')`)
-	db.conn.Exec(`INSERT INTO nodes (public_key, name, role, lat, lon, last_seen, first_seen)
-		VALUES ('bbbb', 'NodeB', 'repeater', 51.5200, -0.1200, '2026-01-01T00:00:00Z', '2025-01-01T00:00:00Z')`)
-
-	cfg := &Config{Port: 3000}
-	hub := NewHub()
-	srv := NewServer(db, cfg, hub)
-	srv.store = NewPacketStore(db, nil)
-
-	now := time.Now()
-	srv.neighborGraph = makeTestGraph(newEdge("aaaa", "bbbb", "bb", 50, now))
-
-	rr := serveRequest(srv, "GET", "/api/nodes/aaaa/neighbors")
-	var resp NeighborResponse
-	json.Unmarshal(rr.Body.Bytes(), &resp)
-
-	if len(resp.Neighbors) != 1 {
-		t.Fatalf("expected 1 neighbor, got %d", len(resp.Neighbors))
-	}
-	n := resp.Neighbors[0]
-	if n.DistanceKm == nil {
-		t.Fatal("expected distance_km to be set for GPS-enabled nodes")
-	}
-	if *n.DistanceKm <= 0 {
-		t.Errorf("expected positive distance, got %f", *n.DistanceKm)
-	}
-}
-
-func TestNeighborAPI_DistanceKm_NoGPS(t *testing.T) {
-	db := setupTestDB(t)
-	defer db.Close()
-
-	// Nodes with 0,0 coords → HasGPS=false
-	db.conn.Exec(`INSERT INTO nodes (public_key, name, role, lat, lon, last_seen, first_seen)
-		VALUES ('aaaa', 'NodeA', 'repeater', 0, 0, '2026-01-01T00:00:00Z', '2025-01-01T00:00:00Z')`)
-	db.conn.Exec(`INSERT INTO nodes (public_key, name, role, lat, lon, last_seen, first_seen)
-		VALUES ('bbbb', 'NodeB', 'repeater', 0, 0, '2026-01-01T00:00:00Z', '2025-01-01T00:00:00Z')`)
-
-	cfg := &Config{Port: 3000}
-	hub := NewHub()
-	srv := NewServer(db, cfg, hub)
-	srv.store = NewPacketStore(db, nil)
-
-	now := time.Now()
-	srv.neighborGraph = makeTestGraph(newEdge("aaaa", "bbbb", "bb", 50, now))
-
-	rr := serveRequest(srv, "GET", "/api/nodes/aaaa/neighbors")
-	var resp NeighborResponse
-	json.Unmarshal(rr.Body.Bytes(), &resp)
-
-	if len(resp.Neighbors) != 1 {
-		t.Fatalf("expected 1 neighbor, got %d", len(resp.Neighbors))
-	}
-	if resp.Neighbors[0].DistanceKm != nil {
-		t.Errorf("expected nil distance_km for nodes without GPS, got %f", *resp.Neighbors[0].DistanceKm)
-	}
-}
-
 func TestNeighborGraphAPI_RegionFilter(t *testing.T) {
 	now := time.Now()
 	// Edge with observer "obs-sjc" — would match region SJC if we had region resolution.

cmd/server/neighbor_graph.go

@@ -542,24 +542,3 @@ func minLen(s string, n int) int {
 	}
 	return n
 }
-
-// PruneOlderThan removes all edges with LastSeen before cutoff.
-// Returns the number of edges removed.
-func (g *NeighborGraph) PruneOlderThan(cutoff time.Time) int {
-	g.mu.Lock()
-	defer g.mu.Unlock()
-
-	pruned := 0
-	for key, edge := range g.edges {
-		if edge.LastSeen.Before(cutoff) {
-			// Remove from byNode index
-			g.removeFromByNode(edge.NodeA, edge)
-			if edge.NodeB != "" {
-				g.removeFromByNode(edge.NodeB, edge)
-			}
-			delete(g.edges, key)
-			pruned++
-		}
-	}
-	return pruned
-}

cmd/server/neighbor_persist.go

@@ -343,175 +343,112 @@ func unmarshalResolvedPath(s string) []*string {
 	return result
 }
 
-
-// backfillResolvedPathsAsync processes observations with NULL resolved_path in
-// chunks, yielding between batches so HTTP handlers remain responsive. It sets
-// store.backfillComplete when finished and re-picks best observations for any
-// transmissions affected by newly resolved paths.
-func backfillResolvedPathsAsync(store *PacketStore, dbPath string, chunkSize int, yieldDuration time.Duration, backfillHours int) {
-	defer func() {
-		if r := recover(); r != nil {
-			log.Printf("[store] backfillResolvedPathsAsync panic recovered: %v", r)
-		}
-	}()
-	// Collect ALL pending obs refs upfront in one pass under a single RLock (fix A).
+// backfillResolvedPaths resolves paths for all observations that have NULL resolved_path.
+func backfillResolvedPaths(store *PacketStore, dbPath string) int {
+	// Collect pending observations and snapshot immutable fields under read lock.
+	// graph is set in main.go before backfill is called; nil-safe throughout (review item #6).
 	type obsRef struct {
-		obsID       int
-		pathJSON    string
-		observerID  string
-		txJSON      string
+		obsID      int
+		pathJSON   string
+		observerID string
+		txJSON     string // snapshot of DecodedJSON for extractFromNode
 		payloadType *int
-		txHash      string // to re-pick best obs
 	}
-
-	cutoff := time.Now().UTC().Add(-time.Duration(backfillHours) * time.Hour)
-
 	store.mu.RLock()
 	pm := store.nodePM
-	var allPending []obsRef
+	graph := store.graph
+	var pending []obsRef
 	for _, tx := range store.packets {
-		// Skip transmissions older than the backfill window.
-		if tx.FirstSeen != "" {
-			if ts, err := time.Parse(time.RFC3339Nano, tx.FirstSeen); err == nil && ts.Before(cutoff) {
-				continue
-			}
-			// Also try the common SQLite format
-			if ts, err := time.Parse("2006-01-02 15:04:05", tx.FirstSeen); err == nil && ts.Before(cutoff) {
-				continue
-			}
-		}
 		for _, obs := range tx.Observations {
 			if obs.ResolvedPath == nil && obs.PathJSON != "" && obs.PathJSON != "[]" {
-				allPending = append(allPending, obsRef{
+				pending = append(pending, obsRef{
 					obsID:       obs.ID,
 					pathJSON:    obs.PathJSON,
 					observerID:  obs.ObserverID,
 					txJSON:      tx.DecodedJSON,
 					payloadType: tx.PayloadType,
-					txHash:      tx.Hash,
 				})
 			}
 		}
 	}
 	store.mu.RUnlock()
 
-	totalPending := len(allPending)
-	if totalPending == 0 || pm == nil {
-		store.backfillComplete.Store(true)
-		log.Printf("[store] async resolved_path backfill: nothing to do")
-		return
+	if len(pending) == 0 || pm == nil {
+		return 0
 	}
 
-	store.backfillTotal.Store(int64(totalPending))
-	store.backfillProcessed.Store(0)
-	log.Printf("[store] async resolved_path backfill starting: %d observations", totalPending)
-
-	// Open RW connection once before the chunk loop (fix B).
-	var rw *sql.DB
-	if dbPath != "" {
-		var err error
-		rw, err = openRW(dbPath)
-		if err != nil {
-			log.Printf("[store] async backfill: open rw error: %v", err)
+	// Resolve paths outside the lock — resolvePathForObs only reads pm and graph.
+	type resolved struct {
+		obsID  int
+		rp     []*string
+		rpJSON string
+	}
+	var results []resolved
+	for _, ref := range pending {
+		// Build a minimal StoreTx for extractFromNode (only needs DecodedJSON + PayloadType).
+		fakeTx := &StoreTx{DecodedJSON: ref.txJSON, PayloadType: ref.payloadType}
+		rp := resolvePathForObs(ref.pathJSON, ref.observerID, fakeTx, pm, graph)
+		if len(rp) > 0 {
+			rpJSON := marshalResolvedPath(rp)
+			if rpJSON != "" {
+				results = append(results, resolved{ref.obsID, rp, rpJSON})
+			}
 		}
 	}
-	defer func() {
-		if rw != nil {
-			rw.Close()
-		}
-	}()
 
-	totalProcessed := 0
-	for totalProcessed < totalPending {
-		end := totalProcessed + chunkSize
-		if end > totalPending {
-			end = totalPending
-		}
-		chunk := allPending[totalProcessed:end]
-
-		// Re-read graph under RLock at the start of each chunk so we pick up
-		// a freshly-built graph once the background build goroutine completes,
-		// instead of using the potentially-empty graph captured at cold start.
-		store.mu.RLock()
-		graph := store.graph
-		store.mu.RUnlock()
-
-		// Resolve paths outside any lock.
-		type resolved struct {
-			obsID  int
-			rp     []*string
-			rpJSON string
-			txHash string
-		}
-		var results []resolved
-		for _, ref := range chunk {
-			fakeTx := &StoreTx{DecodedJSON: ref.txJSON, PayloadType: ref.payloadType}
-			rp := resolvePathForObs(ref.pathJSON, ref.observerID, fakeTx, pm, graph)
-			if len(rp) > 0 {
-				rpJSON := marshalResolvedPath(rp)
-				if rpJSON != "" {
-					results = append(results, resolved{ref.obsID, rp, rpJSON, ref.txHash})
-				}
-			}
-		}
-
-		// Persist to SQLite using the shared connection.
-		if len(results) > 0 && rw != nil {
-			sqlTx, err := rw.Begin()
-			if err != nil {
-				log.Printf("[store] async backfill: begin tx error: %v", err)
-			} else {
-				stmt, err := sqlTx.Prepare("UPDATE observations SET resolved_path = ? WHERE id = ?")
-				if err != nil {
-					log.Printf("[store] async backfill: prepare error: %v", err)
-					sqlTx.Rollback()
-				} else {
-					var execErr error
-					for _, r := range results {
-						if _, e := stmt.Exec(r.rpJSON, r.obsID); e != nil && execErr == nil {
-							execErr = e
-						}
-					}
-					if execErr != nil {
-						log.Printf("[store] async backfill: exec error (first): %v", execErr)
-					}
-					stmt.Close()
-					if err := sqlTx.Commit(); err != nil {
-						log.Printf("[store] async backfill: commit error: %v", err)
-					}
-				}
-			}
-
-			// Update in-memory state and re-pick best observation under a single
-			// write lock. The per-tx pickBestObservation is O(observations) which is
-			// typically <10 per tx — negligible cost vs. the race risk of splitting
-			// the lock (pollAndMerge can append to tx.Observations concurrently).
-			store.mu.Lock()
-			affectedSet := make(map[string]bool)
-			for _, r := range results {
-				if obs, ok := store.byObsID[r.obsID]; ok {
-					obs.ResolvedPath = r.rp
-				}
-				if !affectedSet[r.txHash] {
-					affectedSet[r.txHash] = true
-					if tx, ok := store.byHash[r.txHash]; ok {
-						pickBestObservation(tx)
-					}
-				}
-			}
-			store.mu.Unlock()
-		}
-
-		totalProcessed += len(chunk)
-		store.backfillProcessed.Store(int64(totalProcessed))
-		pct := float64(totalProcessed) / float64(totalPending) * 100
-		log.Printf("[store] backfill progress: %d/%d observations (%.1f%%)", totalProcessed, totalPending, pct)
-
-		time.Sleep(yieldDuration)
+	if len(results) == 0 {
+		return 0
 	}
 
-	store.backfillComplete.Store(true)
-	log.Printf("[store] async resolved_path backfill complete: %d observations processed", totalProcessed)
+	// Persist to SQLite (no lock needed — separate RW connection).
+	rw, err := openRW(dbPath)
+	if err != nil {
+		log.Printf("[store] backfill: open rw error: %v", err)
+		return 0
+	}
+	defer rw.Close()
+
+	sqlTx, err := rw.Begin()
+	if err != nil {
+		log.Printf("[store] backfill: begin tx error: %v", err)
+		return 0
+	}
+	defer sqlTx.Rollback()
+
+	stmt, err := sqlTx.Prepare("UPDATE observations SET resolved_path = ? WHERE id = ?")
+	if err != nil {
+		log.Printf("[store] backfill: prepare error: %v", err)
+		return 0
+	}
+	defer stmt.Close()
+
+	var firstErr error
+	for _, r := range results {
+		if _, err := stmt.Exec(r.rpJSON, r.obsID); err != nil && firstErr == nil {
+			firstErr = err
+		}
+	}
+	if firstErr != nil {
+		log.Printf("[store] backfill resolved_path exec error (first): %v", firstErr)
+	}
+
+	if err := sqlTx.Commit(); err != nil {
+		log.Printf("[store] backfill: commit error: %v", err)
+		return 0
+	}
+
+	// Update in-memory state under write lock.
+	store.mu.Lock()
+	count := 0
+	for _, r := range results {
+		if obs, ok := store.byObsID[r.obsID]; ok {
+			obs.ResolvedPath = r.rp
+			count++
+		}
+	}
+	store.mu.Unlock()
+
+	return count
 }
 
 // ─── Shared helpers ────────────────────────────────────────────────────────────
@@ -592,34 +529,3 @@ func openRW(dbPath string) (*sql.DB, error) {
 	rw.SetMaxOpenConns(1)
 	return rw, nil
 }
-
-// PruneNeighborEdges removes edges older than maxAgeDays from both SQLite and
-// the in-memory graph. Uses openRW internally because the shared database.conn
-// is opened with mode=ro and DELETEs would silently fail.
-func PruneNeighborEdges(dbPath string, graph *NeighborGraph, maxAgeDays int) (int, error) {
-	cutoff := time.Now().UTC().Add(-time.Duration(maxAgeDays) * 24 * time.Hour)
-
-	// 1. Prune from SQLite using a read-write connection
-	var dbPruned int64
-	rw, err := openRW(dbPath)
-	if err != nil {
-		return 0, fmt.Errorf("prune neighbor_edges: open rw: %w", err)
-	}
-	defer rw.Close()
-	res, err := rw.Exec("DELETE FROM neighbor_edges WHERE last_seen < ?", cutoff.Format(time.RFC3339))
-	if err != nil {
-		return 0, fmt.Errorf("prune neighbor_edges: %w", err)
-	}
-	dbPruned, _ = res.RowsAffected()
-
-	// 2. Prune from in-memory graph
-	memPruned := 0
-	if graph != nil {
-		memPruned = graph.PruneOlderThan(cutoff)
-	}
-
-	if dbPruned > 0 || memPruned > 0 {
-		log.Printf("[neighbor-prune] removed %d DB rows, %d in-memory edges older than %d days", dbPruned, memPruned, maxAgeDays)
-	}
-	return int(dbPruned), nil
-}

cmd/server/openapi.go

@@ -1,359 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"fmt"
-	"net/http"
-	"sort"
-	"strings"
-
-	"github.com/gorilla/mux"
-)
-
-// routeMeta holds metadata for a single API route.
-type routeMeta struct {
-	Summary     string   `json:"summary"`
-	Description string   `json:"description,omitempty"`
-	Tag         string   `json:"tag"`
-	Auth        bool     `json:"auth,omitempty"`
-	QueryParams []paramMeta `json:"queryParams,omitempty"`
-}
-
-type paramMeta struct {
-	Name        string `json:"name"`
-	Description string `json:"description"`
-	Required    bool   `json:"required,omitempty"`
-	Type        string `json:"type"` // "string", "integer", "boolean"
-}
-
-// routeDescriptions returns metadata for all known API routes.
-// Key format: "METHOD /path/pattern"
-func routeDescriptions() map[string]routeMeta {
-	return map[string]routeMeta{
-		// Config
-		"GET /api/config/cache":      {Summary: "Get cache configuration", Tag: "config"},
-		"GET /api/config/client":     {Summary: "Get client configuration", Tag: "config"},
-		"GET /api/config/regions":    {Summary: "Get configured regions", Tag: "config"},
-		"GET /api/config/theme":      {Summary: "Get theme configuration", Description: "Returns color maps, CSS variables, and theme defaults.", Tag: "config"},
-		"GET /api/config/map":        {Summary: "Get map configuration", Tag: "config"},
-		"GET /api/config/geo-filter": {Summary: "Get geo-filter configuration", Tag: "config"},
-
-		// Admin / system
-		"GET /api/health":     {Summary: "Health check", Description: "Returns server health, uptime, and memory stats.", Tag: "admin"},
-		"GET /api/stats":      {Summary: "Network statistics", Description: "Returns aggregate stats (node counts, packet counts, observer counts). Cached for 10s.", Tag: "admin"},
-		"GET /api/perf":       {Summary: "Performance statistics", Description: "Returns per-endpoint request timing and slow query log.", Tag: "admin"},
-		"POST /api/perf/reset": {Summary: "Reset performance stats", Tag: "admin", Auth: true},
-		"POST /api/admin/prune": {Summary: "Prune old data", Description: "Deletes packets and nodes older than the configured retention period.", Tag: "admin", Auth: true},
-		"GET /api/debug/affinity": {Summary: "Debug neighbor affinity scores", Tag: "admin", Auth: true},
-
-		// Packets
-		"GET /api/packets": {Summary: "List packets", Description: "Returns decoded packets with filtering, sorting, and pagination.", Tag: "packets",
-			QueryParams: []paramMeta{
-				{Name: "limit", Description: "Max packets to return", Type: "integer"},
-				{Name: "offset", Description: "Pagination offset", Type: "integer"},
-				{Name: "sort", Description: "Sort field", Type: "string"},
-				{Name: "order", Description: "Sort order (asc/desc)", Type: "string"},
-				{Name: "type", Description: "Filter by packet type", Type: "string"},
-				{Name: "observer", Description: "Filter by observer ID", Type: "string"},
-				{Name: "timeRange", Description: "Time range filter (e.g. 1h, 24h, 7d)", Type: "string"},
-				{Name: "search", Description: "Full-text search", Type: "string"},
-				{Name: "groupByHash", Description: "Group duplicate packets by hash", Type: "boolean"},
-			}},
-		"POST /api/packets":              {Summary: "Ingest a packet", Description: "Submit a raw packet for decoding and storage.", Tag: "packets", Auth: true},
-		"GET /api/packets/{id}":          {Summary: "Get packet detail", Tag: "packets"},
-		"GET /api/packets/timestamps":    {Summary: "Get packet timestamp ranges", Tag: "packets"},
-		"POST /api/packets/observations": {Summary: "Batch submit observations", Description: "Submit multiple observer sightings for existing packets.", Tag: "packets"},
-
-		// Decode
-		"POST /api/decode": {Summary: "Decode a raw packet", Description: "Decodes a hex-encoded packet without storing it.", Tag: "packets"},
-
-		// Nodes
-		"GET /api/nodes": {Summary: "List nodes", Description: "Returns all known mesh nodes with status and metadata.", Tag: "nodes",
-			QueryParams: []paramMeta{
-				{Name: "role", Description: "Filter by node role", Type: "string"},
-				{Name: "status", Description: "Filter by status (active/stale/offline)", Type: "string"},
-			}},
-		"GET /api/nodes/search":           {Summary: "Search nodes", Description: "Search nodes by name or public key prefix.", Tag: "nodes", QueryParams: []paramMeta{{Name: "q", Description: "Search query", Type: "string", Required: true}}},
-		"GET /api/nodes/bulk-health":       {Summary: "Bulk node health", Description: "Returns health status for all nodes in one call.", Tag: "nodes"},
-		"GET /api/nodes/network-status":    {Summary: "Network status summary", Description: "Returns counts of active, stale, and offline nodes.", Tag: "nodes"},
-		"GET /api/nodes/{pubkey}":          {Summary: "Get node detail", Description: "Returns full detail for a single node by public key.", Tag: "nodes"},
-		"GET /api/nodes/{pubkey}/health":   {Summary: "Get node health", Tag: "nodes"},
-		"GET /api/nodes/{pubkey}/paths":    {Summary: "Get node routing paths", Tag: "nodes"},
-		"GET /api/nodes/{pubkey}/analytics": {Summary: "Get node analytics", Description: "Per-node packet counts, timing, and RF stats.", Tag: "nodes"},
-		"GET /api/nodes/{pubkey}/neighbors": {Summary: "Get node neighbors", Description: "Returns neighbor nodes with affinity scores.", Tag: "nodes"},
-
-		// Analytics
-		"GET /api/analytics/rf":               {Summary: "RF analytics", Description: "SNR/RSSI distributions and statistics.", Tag: "analytics"},
-		"GET /api/analytics/topology":          {Summary: "Network topology", Description: "Hop-count distribution and route analysis.", Tag: "analytics"},
-		"GET /api/analytics/channels":          {Summary: "Channel analytics", Description: "Message counts and activity per channel.", Tag: "analytics"},
-		"GET /api/analytics/distance":          {Summary: "Distance analytics", Description: "Geographic distance calculations between nodes.", Tag: "analytics"},
-		"GET /api/analytics/hash-sizes":        {Summary: "Hash size analysis", Description: "Distribution of hash prefix sizes across the network.", Tag: "analytics"},
-		"GET /api/analytics/hash-collisions":   {Summary: "Hash collision detection", Description: "Identifies nodes sharing hash prefixes.", Tag: "analytics"},
-		"GET /api/analytics/subpaths":          {Summary: "Subpath analysis", Description: "Common routing subpaths through the mesh.", Tag: "analytics"},
-		"GET /api/analytics/subpaths-bulk":     {Summary: "Bulk subpath analysis", Tag: "analytics"},
-		"GET /api/analytics/subpath-detail":    {Summary: "Subpath detail", Tag: "analytics"},
-		"GET /api/analytics/neighbor-graph":    {Summary: "Neighbor graph", Description: "Full neighbor affinity graph for visualization.", Tag: "analytics"},
-
-		// Channels
-		"GET /api/channels":                 {Summary: "List channels", Description: "Returns known mesh channels with message counts.", Tag: "channels"},
-		"GET /api/channels/{hash}/messages": {Summary: "Get channel messages", Description: "Returns messages for a specific channel.", Tag: "channels"},
-
-		// Observers
-		"GET /api/observers":                    {Summary: "List observers", Description: "Returns all known packet observers/gateways.", Tag: "observers"},
-		"GET /api/observers/{id}":               {Summary: "Get observer detail", Tag: "observers"},
-		"GET /api/observers/{id}/metrics":       {Summary: "Get observer metrics", Description: "Packet rates, uptime, and performance metrics.", Tag: "observers"},
-		"GET /api/observers/{id}/analytics":     {Summary: "Get observer analytics", Tag: "observers"},
-		"GET /api/observers/metrics/summary":    {Summary: "Observer metrics summary", Description: "Aggregate metrics across all observers.", Tag: "observers"},
-
-		// Misc
-		"GET /api/resolve-hops":      {Summary: "Resolve hop path", Description: "Resolves hash prefixes in a hop path to node names. Returns affinity scores and best candidates.", Tag: "nodes", QueryParams: []paramMeta{{Name: "hops", Description: "Comma-separated hop hash prefixes", Type: "string", Required: true}}},
-		"GET /api/traces/{hash}":     {Summary: "Get packet traces", Description: "Returns all observer sightings for a packet hash.", Tag: "packets"},
-		"GET /api/iata-coords":       {Summary: "Get IATA airport coordinates", Description: "Returns lat/lon for known airport codes (used for observer positioning).", Tag: "config"},
-		"GET /api/audio-lab/buckets": {Summary: "Audio lab frequency buckets", Description: "Returns frequency bucket data for audio analysis.", Tag: "analytics"},
-	}
-}
-
-// buildOpenAPISpec constructs an OpenAPI 3.0 spec by walking the mux router.
-func buildOpenAPISpec(router *mux.Router, version string) map[string]interface{} {
-	descriptions := routeDescriptions()
-
-	// Collect routes from the router
-	type routeInfo struct {
-		path    string
-		method  string
-		authReq bool
-	}
-	var routes []routeInfo
-
-	router.Walk(func(route *mux.Route, router *mux.Router, ancestors []*mux.Route) error {
-		path, err := route.GetPathTemplate()
-		if err != nil {
-			return nil
-		}
-		if !strings.HasPrefix(path, "/api/") {
-			return nil
-		}
-		// Skip the spec/docs endpoints themselves
-		if path == "/api/spec" || path == "/api/docs" {
-			return nil
-		}
-		methods, err := route.GetMethods()
-		if err != nil {
-			return nil
-		}
-		for _, m := range methods {
-			routes = append(routes, routeInfo{path: path, method: m})
-		}
-		return nil
-	})
-
-	// Sort routes for deterministic output
-	sort.Slice(routes, func(i, j int) bool {
-		if routes[i].path != routes[j].path {
-			return routes[i].path < routes[j].path
-		}
-		return routes[i].method < routes[j].method
-	})
-
-	// Build paths object
-	paths := make(map[string]interface{})
-	tagSet := make(map[string]bool)
-
-	for _, ri := range routes {
-		key := ri.method + " " + ri.path
-		meta, hasMeta := descriptions[key]
-
-		// Convert mux path params {name} to OpenAPI {name} (same format, convenient)
-		openAPIPath := ri.path
-
-		// Build operation
-		op := map[string]interface{}{
-			"summary": func() string {
-				if hasMeta {
-					return meta.Summary
-				}
-				return ri.path
-			}(),
-			"responses": map[string]interface{}{
-				"200": map[string]interface{}{
-					"description": "Success",
-					"content": map[string]interface{}{
-						"application/json": map[string]interface{}{
-							"schema": map[string]interface{}{"type": "object"},
-						},
-					},
-				},
-			},
-		}
-
-		if hasMeta {
-			if meta.Description != "" {
-				op["description"] = meta.Description
-			}
-			if meta.Tag != "" {
-				op["tags"] = []string{meta.Tag}
-				tagSet[meta.Tag] = true
-			}
-			if meta.Auth {
-				op["security"] = []map[string]interface{}{
-					{"ApiKeyAuth": []string{}},
-				}
-			}
-
-			// Add query parameters
-			if len(meta.QueryParams) > 0 {
-				params := make([]interface{}, 0, len(meta.QueryParams))
-				for _, qp := range meta.QueryParams {
-					p := map[string]interface{}{
-						"name":     qp.Name,
-						"in":       "query",
-						"required": qp.Required,
-						"schema":   map[string]interface{}{"type": qp.Type},
-					}
-					if qp.Description != "" {
-						p["description"] = qp.Description
-					}
-					params = append(params, p)
-				}
-				op["parameters"] = params
-			}
-		}
-
-		// Extract path parameters from {name} patterns
-		pathParams := extractPathParams(openAPIPath)
-		if len(pathParams) > 0 {
-			existing, _ := op["parameters"].([]interface{})
-			for _, pp := range pathParams {
-				existing = append(existing, map[string]interface{}{
-					"name":     pp,
-					"in":       "path",
-					"required": true,
-					"schema":   map[string]interface{}{"type": "string"},
-				})
-			}
-			op["parameters"] = existing
-		}
-
-		// Add to paths
-		methodLower := strings.ToLower(ri.method)
-		if _, ok := paths[openAPIPath]; !ok {
-			paths[openAPIPath] = make(map[string]interface{})
-		}
-		paths[openAPIPath].(map[string]interface{})[methodLower] = op
-	}
-
-	// Build tags array (sorted)
-	tagOrder := []string{"admin", "analytics", "channels", "config", "nodes", "observers", "packets"}
-	tagDescriptions := map[string]string{
-		"admin":     "Server administration and diagnostics",
-		"analytics": "Network analytics and statistics",
-		"channels":  "Mesh channel operations",
-		"config":    "Server configuration",
-		"nodes":     "Mesh node operations",
-		"observers": "Packet observer/gateway operations",
-		"packets":   "Packet capture and decoding",
-	}
-	var tags []interface{}
-	for _, t := range tagOrder {
-		if tagSet[t] {
-			tags = append(tags, map[string]interface{}{
-				"name":        t,
-				"description": tagDescriptions[t],
-			})
-		}
-	}
-
-	spec := map[string]interface{}{
-		"openapi": "3.0.3",
-		"info": map[string]interface{}{
-			"title":       "CoreScope API",
-			"description": "MeshCore network analyzer — packet capture, node tracking, and mesh analytics.",
-			"version":     version,
-			"license": map[string]interface{}{
-				"name": "MIT",
-			},
-		},
-		"paths": paths,
-		"tags":  tags,
-		"components": map[string]interface{}{
-			"securitySchemes": map[string]interface{}{
-				"ApiKeyAuth": map[string]interface{}{
-					"type": "apiKey",
-					"in":   "header",
-					"name": "X-API-Key",
-				},
-			},
-		},
-	}
-
-	return spec
-}
-
-// extractPathParams returns parameter names from a mux-style path like /api/nodes/{pubkey}.
-func extractPathParams(path string) []string {
-	var params []string
-	for {
-		start := strings.Index(path, "{")
-		if start == -1 {
-			break
-		}
-		end := strings.Index(path[start:], "}")
-		if end == -1 {
-			break
-		}
-		params = append(params, path[start+1:start+end])
-		path = path[start+end+1:]
-	}
-	return params
-}
-
-// handleOpenAPISpec serves the OpenAPI 3.0 spec as JSON.
-// The router is injected via RegisterRoutes storing it on the Server.
-func (s *Server) handleOpenAPISpec(w http.ResponseWriter, r *http.Request) {
-	spec := buildOpenAPISpec(s.router, s.version)
-
-	w.Header().Set("Content-Type", "application/json; charset=utf-8")
-	w.Header().Set("Access-Control-Allow-Origin", "*")
-	enc := json.NewEncoder(w)
-	enc.SetIndent("", "  ")
-	if err := enc.Encode(spec); err != nil {
-		http.Error(w, fmt.Sprintf("failed to encode spec: %v", err), http.StatusInternalServerError)
-	}
-}
-
-// handleSwaggerUI serves a minimal Swagger UI page.
-func (s *Server) handleSwaggerUI(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "text/html; charset=utf-8")
-	fmt.Fprint(w, swaggerUIHTML)
-}
-
-const swaggerUIHTML = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <title>CoreScope API — Swagger UI</title>
-  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
-  <style>
-    html { box-sizing: border-box; overflow-y: scroll; }
-    *, *:before, *:after { box-sizing: inherit; }
-    body { margin: 0; background: #fafafa; }
-    .topbar { display: none; }
-  </style>
-</head>
-<body>
-  <div id="swagger-ui"></div>
-  <script src="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js"></script>
-  <script>
-    SwaggerUIBundle({
-      url: '/api/spec',
-      dom_id: '#swagger-ui',
-      deepLinking: true,
-      presets: [
-        SwaggerUIBundle.presets.apis,
-        SwaggerUIBundle.SwaggerUIStandalonePreset
-      ],
-      layout: 'BaseLayout'
-    });
-  </script>
-</body>
-</html>`

cmd/server/openapi_test.go

@@ -1,142 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"net/http"
-	"net/http/httptest"
-	"strings"
-	"testing"
-)
-
-func TestOpenAPISpecEndpoint(t *testing.T) {
-	_, r := setupTestServer(t)
-
-	req := httptest.NewRequest("GET", "/api/spec", nil)
-	w := httptest.NewRecorder()
-	r.ServeHTTP(w, req)
-
-	if w.Code != http.StatusOK {
-		t.Fatalf("expected 200, got %d", w.Code)
-	}
-
-	ct := w.Header().Get("Content-Type")
-	if ct != "application/json; charset=utf-8" {
-		t.Errorf("unexpected content-type: %s", ct)
-	}
-
-	var spec map[string]interface{}
-	if err := json.Unmarshal(w.Body.Bytes(), &spec); err != nil {
-		t.Fatalf("invalid JSON: %v", err)
-	}
-
-	// Check required OpenAPI fields
-	if spec["openapi"] != "3.0.3" {
-		t.Errorf("expected openapi 3.0.3, got %v", spec["openapi"])
-	}
-
-	info, ok := spec["info"].(map[string]interface{})
-	if !ok {
-		t.Fatal("missing info object")
-	}
-	if info["title"] != "CoreScope API" {
-		t.Errorf("unexpected title: %v", info["title"])
-	}
-
-	paths, ok := spec["paths"].(map[string]interface{})
-	if !ok {
-		t.Fatal("missing paths object")
-	}
-
-	// Should have at least 20 paths
-	if len(paths) < 20 {
-		t.Errorf("expected at least 20 paths, got %d", len(paths))
-	}
-
-	// Check a known path exists
-	if _, ok := paths["/api/nodes"]; !ok {
-		t.Error("missing /api/nodes path")
-	}
-	if _, ok := paths["/api/packets"]; !ok {
-		t.Error("missing /api/packets path")
-	}
-
-	// Check tags exist
-	tags, ok := spec["tags"].([]interface{})
-	if !ok || len(tags) == 0 {
-		t.Error("missing or empty tags")
-	}
-
-	// Check security schemes
-	components, ok := spec["components"].(map[string]interface{})
-	if !ok {
-		t.Fatal("missing components")
-	}
-	schemes, ok := components["securitySchemes"].(map[string]interface{})
-	if !ok {
-		t.Fatal("missing securitySchemes")
-	}
-	if _, ok := schemes["ApiKeyAuth"]; !ok {
-		t.Error("missing ApiKeyAuth security scheme")
-	}
-
-	// Spec should NOT contain /api/spec or /api/docs (self-referencing)
-	if _, ok := paths["/api/spec"]; ok {
-		t.Error("/api/spec should not appear in the spec")
-	}
-	if _, ok := paths["/api/docs"]; ok {
-		t.Error("/api/docs should not appear in the spec")
-	}
-}
-
-func TestSwaggerUIEndpoint(t *testing.T) {
-	_, r := setupTestServer(t)
-
-	req := httptest.NewRequest("GET", "/api/docs", nil)
-	w := httptest.NewRecorder()
-	r.ServeHTTP(w, req)
-
-	if w.Code != http.StatusOK {
-		t.Fatalf("expected 200, got %d", w.Code)
-	}
-
-	ct := w.Header().Get("Content-Type")
-	if ct != "text/html; charset=utf-8" {
-		t.Errorf("unexpected content-type: %s", ct)
-	}
-
-	body := w.Body.String()
-	if len(body) < 100 {
-		t.Error("response too short for Swagger UI HTML")
-	}
-	if !strings.Contains(body, "swagger-ui") {
-		t.Error("response doesn't contain swagger-ui reference")
-	}
-	if !strings.Contains(body, "/api/spec") {
-		t.Error("response doesn't point to /api/spec")
-	}
-}
-
-func TestExtractPathParams(t *testing.T) {
-	tests := []struct {
-		path   string
-		expect []string
-	}{
-		{"/api/nodes", nil},
-		{"/api/nodes/{pubkey}", []string{"pubkey"}},
-		{"/api/channels/{hash}/messages", []string{"hash"}},
-	}
-	for _, tt := range tests {
-		got := extractPathParams(tt.path)
-		if len(got) != len(tt.expect) {
-			t.Errorf("extractPathParams(%q) = %v, want %v", tt.path, got, tt.expect)
-			continue
-		}
-		for i := range got {
-			if got[i] != tt.expect[i] {
-				t.Errorf("extractPathParams(%q)[%d] = %q, want %q", tt.path, i, got[i], tt.expect[i])
-			}
-		}
-	}
-}
-
-

cmd/server/routes.go

@@ -1,7 +1,6 @@
 package main
 
 import (
-	"crypto/subtle"
 	"database/sql"
 	"encoding/json"
 	"fmt"
@@ -43,9 +42,6 @@ type Server struct {
 	// Neighbor affinity graph (lazy-built, cached with TTL)
 	neighborMu    sync.Mutex
 	neighborGraph *NeighborGraph
-
-	// Router reference for OpenAPI spec generation
-	router *mux.Router
 }
 
 // PerfStats tracks request performance.
@@ -102,13 +98,9 @@ func (s *Server) getMemStats() runtime.MemStats {
 
 // RegisterRoutes sets up all HTTP routes on the given router.
 func (s *Server) RegisterRoutes(r *mux.Router) {
-	s.router = r
 	// Performance instrumentation middleware
 	r.Use(s.perfMiddleware)
 
-	// Backfill status header middleware
-	r.Use(s.backfillStatusMiddleware)
-
 	// Config endpoints
 	r.HandleFunc("/api/config/cache", s.handleConfigCache).Methods("GET")
 	r.HandleFunc("/api/config/client", s.handleConfigClient).Methods("GET")
@@ -170,21 +162,6 @@ func (s *Server) RegisterRoutes(r *mux.Router) {
 	r.HandleFunc("/api/traces/{hash}", s.handleTraces).Methods("GET")
 	r.HandleFunc("/api/iata-coords", s.handleIATACoords).Methods("GET")
 	r.HandleFunc("/api/audio-lab/buckets", s.handleAudioLabBuckets).Methods("GET")
-
-	// OpenAPI spec + Swagger UI
-	r.HandleFunc("/api/spec", s.handleOpenAPISpec).Methods("GET")
-	r.HandleFunc("/api/docs", s.handleSwaggerUI).Methods("GET")
-}
-
-func (s *Server) backfillStatusMiddleware(next http.Handler) http.Handler {
-	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		if s.store != nil && s.store.backfillComplete.Load() {
-			w.Header().Set("X-CoreScope-Status", "ready")
-		} else {
-			w.Header().Set("X-CoreScope-Status", "backfilling")
-		}
-		next.ServeHTTP(w, r)
-	})
 }
 
 func (s *Server) perfMiddleware(next http.Handler) http.Handler {
@@ -247,15 +224,10 @@ func (s *Server) requireAPIKey(next http.Handler) http.Handler {
 			writeError(w, http.StatusForbidden, "write endpoints disabled — set apiKey in config.json")
 			return
 		}
-		key := r.Header.Get("X-API-Key")
-		if !constantTimeEqual(key, s.cfg.APIKey) {
+		if r.Header.Get("X-API-Key") != s.cfg.APIKey {
 			writeError(w, http.StatusUnauthorized, "unauthorized")
 			return
 		}
-		if IsWeakAPIKey(key) {
-			writeError(w, http.StatusForbidden, "forbidden")
-			return
-		}
 		next.ServeHTTP(w, r)
 	})
 }
@@ -549,19 +521,6 @@ func (s *Server) handleStats(w http.ResponseWriter, r *http.Request) {
 		return
 	}
 	counts := s.db.GetRoleCounts()
-
-	// Compute backfill progress
-	backfilling := s.store != nil && !s.store.backfillComplete.Load()
-	var backfillProgress float64
-	if backfilling && s.store != nil && s.store.backfillTotal.Load() > 0 {
-		backfillProgress = float64(s.store.backfillProcessed.Load()) / float64(s.store.backfillTotal.Load())
-		if backfillProgress > 1 {
-			backfillProgress = 1
-		}
-	} else if !backfilling {
-		backfillProgress = 1
-	}
-
 	resp := &StatsResponse{
 		TotalPackets:       stats.TotalPackets,
 		TotalTransmissions: &stats.TotalTransmissions,
@@ -581,8 +540,6 @@ func (s *Server) handleStats(w http.ResponseWriter, r *http.Request) {
 			Companions: counts["companions"],
 			Sensors:    counts["sensors"],
 		},
-		Backfilling:      backfilling,
-		BackfillProgress: backfillProgress,
 	}
 
 	s.statsMu.Lock()
@@ -930,7 +887,7 @@ func (s *Server) handleDecode(w http.ResponseWriter, r *http.Request) {
 		writeError(w, 400, "hex is required")
 		return
 	}
-	decoded, err := DecodePacket(hexStr, true)
+	decoded, err := DecodePacket(hexStr)
 	if err != nil {
 		writeError(w, 400, err.Error())
 		return
@@ -962,7 +919,7 @@ func (s *Server) handlePostPacket(w http.ResponseWriter, r *http.Request) {
 		writeError(w, 400, "hex is required")
 		return
 	}
-	decoded, err := DecodePacket(hexStr, false)
+	decoded, err := DecodePacket(hexStr)
 	if err != nil {
 		writeError(w, 400, err.Error())
 		return
@@ -1176,17 +1133,6 @@ func (s *Server) handleNodePaths(w http.ResponseWriter, r *http.Request) {
 		}
 	}
 
-	// Post-filter: verify target node actually appears in each candidate's resolved_path.
-	// The byPathHop index uses short prefixes which can collide (e.g. "c0" matches multiple nodes).
-	// We lean on resolved_path (from neighbor affinity graph) to disambiguate.
-	filtered := candidates[:0] // reuse backing array
-	for _, tx := range candidates {
-		if nodeInResolvedPath(tx, lowerPK) {
-			filtered = append(filtered, tx)
-		}
-	}
-	candidates = filtered
-
 	type pathAgg struct {
 		Hops       []PathHopResp
 		Count      int
@@ -2335,8 +2281,3 @@ func (s *Server) handleAdminPrune(w http.ResponseWriter, r *http.Request) {
 	log.Printf("[prune] deleted %d transmissions older than %d days", n, days)
 	writeJSON(w, map[string]interface{}{"deleted": n, "days": days})
 }
-
-// constantTimeEqual compares two strings in constant time to prevent timing attacks.
-func constantTimeEqual(a, b string) bool {
-	return subtle.ConstantTimeCompare([]byte(a), []byte(b)) == 1
-}

cmd/server/routes_test.go

@@ -6,7 +6,6 @@ import (
 	"net/http"
 	"net/http/httptest"
 	"strconv"
-	"strings"
 	"testing"
 	"time"
 
@@ -48,7 +47,7 @@ func setupTestServerWithAPIKey(t *testing.T, apiKey string) (*Server, *mux.Route
 }
 
 func TestWriteEndpointsRequireAPIKey(t *testing.T) {
-	_, router := setupTestServerWithAPIKey(t, "test-secret-key-strong-enough")
+	_, router := setupTestServerWithAPIKey(t, "test-secret")
 
 	t.Run("missing key returns 401", func(t *testing.T) {
 		req := httptest.NewRequest("POST", "/api/perf/reset", nil)
@@ -66,7 +65,7 @@ func TestWriteEndpointsRequireAPIKey(t *testing.T) {
 
 	t.Run("wrong key returns 401", func(t *testing.T) {
 		req := httptest.NewRequest("POST", "/api/perf/reset", nil)
-		req.Header.Set("X-API-Key", "wrong-secret-key-strong-enough")
+		req.Header.Set("X-API-Key", "wrong-secret")
 		w := httptest.NewRecorder()
 		router.ServeHTTP(w, req)
 		if w.Code != http.StatusUnauthorized {
@@ -76,7 +75,7 @@ func TestWriteEndpointsRequireAPIKey(t *testing.T) {
 
 	t.Run("correct key passes", func(t *testing.T) {
 		req := httptest.NewRequest("POST", "/api/perf/reset", nil)
-		req.Header.Set("X-API-Key", "test-secret-key-strong-enough")
+		req.Header.Set("X-API-Key", "test-secret")
 		w := httptest.NewRecorder()
 		router.ServeHTTP(w, req)
 		if w.Code != http.StatusOK {
@@ -2452,7 +2451,6 @@ func TestHashAnalyticsZeroHopAdvert(t *testing.T) {
 
 	pk := "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
 	db.conn.Exec("INSERT OR IGNORE INTO nodes (public_key, name, role) VALUES (?, 'ZeroHop', 'repeater')", pk)
-	store.InvalidateNodeCache()
 
 	decoded := `{"name":"ZeroHop","pubKey":"` + pk + `"}`
 	// header 0x05 → routeType=1 (FLOOD), pathByte=0x00 → hashSize=1
@@ -2506,11 +2504,6 @@ func TestAnalyticsHashSizeSameNameDifferentPubkey(t *testing.T) {
 	pk1 := "aaaa111122223333444455556666777788889999aaaabbbbccccddddeeee1111"
 	pk2 := "aaaa111122223333444455556666777788889999aaaabbbbccccddddeeee2222"
 
-	// Insert both nodes as repeaters so they appear in distributionByRepeaters.
-	db.conn.Exec("INSERT OR IGNORE INTO nodes (public_key, name, role) VALUES (?, 'SameName', 'repeater')", pk1)
-	db.conn.Exec("INSERT OR IGNORE INTO nodes (public_key, name, role) VALUES (?, 'SameName', 'repeater')", pk2)
-	store.InvalidateNodeCache()
-
 	decoded1 := `{"name":"SameName","pubKey":"` + pk1 + `"}`
 	decoded2 := `{"name":"SameName","pubKey":"` + pk2 + `"}`
 
@@ -3193,7 +3186,7 @@ func TestHashCollisionsClassification(t *testing.T) {
 }
 
 func TestHashCollisionsCacheTTL(t *testing.T) {
-	// Issue #420: collision cache should use dedicated TTL, default 3600s (1 hour)
+	// Issue #420: collision cache should use dedicated TTL (60s), not rfCacheTTL (15s)
 	db := setupTestDB(t)
 	seedTestData(t, db)
 	store := NewPacketStore(db, nil)
@@ -3201,8 +3194,8 @@ func TestHashCollisionsCacheTTL(t *testing.T) {
 		t.Fatalf("store.Load failed: %v", err)
 	}
 
-	if store.collisionCacheTTL != 3600*time.Second {
-		t.Errorf("expected collisionCacheTTL=3600s, got %v", store.collisionCacheTTL)
+	if store.collisionCacheTTL != 60*time.Second {
+		t.Errorf("expected collisionCacheTTL=60s, got %v", store.collisionCacheTTL)
 	}
 	if store.rfCacheTTL != 15*time.Second {
 		t.Errorf("expected rfCacheTTL=15s, got %v", store.rfCacheTTL)
@@ -3539,122 +3532,6 @@ func TestNodePathsEndpointUsesIndex(t *testing.T) {
 	}
 }
 
-func TestNodePathsPrefixCollisionFilter(t *testing.T) {
-	// Two nodes share the "aa" prefix: TestRepeater (aabbccdd11223344) and a
-	// second node (aacafe0000000000). Packets whose resolved_path points to
-	// the second node must NOT appear when querying TestRepeater's paths.
-	srv, router := setupTestServer(t)
-
-	// Manually inject a transmission whose raw path contains "aa" but whose
-	// resolved_path points to the other node (aacafe0000000000).
-	now := time.Now().UTC()
-	recent := now.Add(-30 * time.Minute).Format(time.RFC3339)
-	recentEpoch := now.Add(-30 * time.Minute).Unix()
-
-	// Insert a second node with the same 2-char prefix
-	srv.db.conn.Exec(`INSERT OR IGNORE INTO nodes (public_key, name, role, last_seen, first_seen, advert_count)
-		VALUES ('aacafe0000000000', 'CollisionNode', 'repeater', ?, '2026-01-01T00:00:00Z', 5)`, recent)
-
-	// Insert a transmission with path hop "aa" that resolves to the OTHER node
-	srv.db.conn.Exec(`INSERT INTO transmissions (raw_hex, hash, first_seen, route_type, payload_type, decoded_json)
-		VALUES ('FF01', 'collision_test_hash', ?, 1, 4, '{}')`, recent)
-	// Get its ID
-	var collisionTxID int
-	srv.db.conn.QueryRow(`SELECT id FROM transmissions WHERE hash='collision_test_hash'`).Scan(&collisionTxID)
-
-	srv.db.conn.Exec(`INSERT INTO observations (transmission_id, observer_idx, snr, rssi, path_json, timestamp, resolved_path)
-		VALUES (?, 1, 10.0, -90, '["aa","bb"]', ?, '["aacafe0000000000","eeff00112233aabb"]')`,
-		collisionTxID, recentEpoch)
-
-	// Reload store to pick up new data
-	store := NewPacketStore(srv.db, nil)
-	if err := store.Load(); err != nil {
-		t.Fatalf("store.Load failed: %v", err)
-	}
-	srv.store = store
-
-	// Query paths for TestRepeater — should NOT include the collision packet
-	req := httptest.NewRequest("GET", "/api/nodes/aabbccdd11223344/paths", nil)
-	w := httptest.NewRecorder()
-	router.ServeHTTP(w, req)
-
-	if w.Code != 200 {
-		t.Fatalf("expected 200, got %d: %s", w.Code, w.Body.String())
-	}
-
-	var resp struct {
-		Paths              []json.RawMessage `json:"paths"`
-		TotalTransmissions int               `json:"totalTransmissions"`
-	}
-	if err := json.Unmarshal(w.Body.Bytes(), &resp); err != nil {
-		t.Fatalf("bad JSON: %v", err)
-	}
-
-	// The collision packet should be filtered out. Only transmission 1 (and 3
-	// if prefix matches) should remain — but transmission 3 has path "cc" and
-	// resolved_path pointing to TestRoom, so only tx 1 should match.
-	// Check that collision_test_hash is not in any path group.
-	bodyStr := w.Body.String()
-	if strings.Contains(bodyStr, "collision_test_hash") {
-		t.Error("collision packet should have been filtered out but appeared in response")
-	}
-
-	// Query paths for CollisionNode — should include the collision packet
-	req2 := httptest.NewRequest("GET", "/api/nodes/aacafe0000000000/paths", nil)
-	w2 := httptest.NewRecorder()
-	router.ServeHTTP(w2, req2)
-
-	if w2.Code != 200 {
-		t.Fatalf("expected 200 for CollisionNode, got %d: %s", w2.Code, w2.Body.String())
-	}
-
-	body2 := w2.Body.String()
-	if !strings.Contains(body2, "collision_test_hash") {
-		t.Error("collision packet should appear for CollisionNode but was missing")
-	}
-}
-
-func TestNodeInResolvedPath(t *testing.T) {
-	target := "aabbccdd11223344"
-
-	// Case 1: tx.ResolvedPath contains target
-	pk := "aabbccdd11223344"
-	tx1 := &StoreTx{ResolvedPath: []*string{&pk}}
-	if !nodeInResolvedPath(tx1, target) {
-		t.Error("should match when ResolvedPath contains target")
-	}
-
-	// Case 2: tx.ResolvedPath contains different node
-	other := "aacafe0000000000"
-	tx2 := &StoreTx{ResolvedPath: []*string{&other}}
-	if nodeInResolvedPath(tx2, target) {
-		t.Error("should not match when ResolvedPath contains different node")
-	}
-
-	// Case 3: nil ResolvedPath — should match (no data to disambiguate, keep it)
-	tx3 := &StoreTx{}
-	if !nodeInResolvedPath(tx3, target) {
-		t.Error("should match when ResolvedPath is nil (no data to disambiguate)")
-	}
-
-	// Case 4: ResolvedPath with nil elements only — has data but no match
-	tx4 := &StoreTx{ResolvedPath: []*string{nil, nil}}
-	if nodeInResolvedPath(tx4, target) {
-		t.Error("should not match when all ResolvedPath elements are nil")
-	}
-
-	// Case 5: target in observation but not in tx.ResolvedPath
-	tx5 := &StoreTx{
-		ResolvedPath: []*string{&other},
-		Observations: []*StoreObs{
-			{ResolvedPath: []*string{&pk}},
-		},
-	}
-	if !nodeInResolvedPath(tx5, target) {
-		t.Error("should match when observation's ResolvedPath contains target")
-	}
-}
-
 func TestPathHopIndexIncrementalUpdate(t *testing.T) {
 	// Test that addTxToPathHopIndex and removeTxFromPathHopIndex work correctly
 	idx := make(map[string][]*StoreTx)

cmd/server/store.go

@@ -80,45 +80,6 @@ func (tx *StoreTx) ParsedDecoded() map[string]interface{} {
 }
 
 // PacketStore holds all transmissions in memory with indexes for fast queries.
-//
-// Lock ordering
-// =============
-// PacketStore uses several mutexes. To prevent deadlocks, locks MUST be
-// acquired in the order listed below. Never acquire a higher-numbered lock
-// while holding a lower-numbered one.
-//
-//   1. mu            (sync.RWMutex) — guards the core packet data: packets,
-//                     indexes (byHash, byTxID, byObsID, byObserver, byNode,
-//                     byPathHop, byPayloadType), counters, and loaded flag.
-//
-//   2. cacheMu       (sync.Mutex)  — guards analytics response caches:
-//                     rfCache, topoCache, hashCache, collisionCache, chanCache,
-//                     distCache, subpathCache, and their TTLs/hit counters.
-//                     Also guards rate-limited invalidation state
-//                     (lastInvalidated, pendingInv).
-//
-//   3. channelsCacheMu (sync.Mutex) — guards the short-lived GetChannels
-//                     cache (channelsCacheKey/Exp/Res).
-//
-//   4. groupedCacheMu (sync.Mutex)  — guards the short-lived
-//                     QueryGroupedPackets cache.
-//
-//   5. regionObsMu   (sync.Mutex)  — guards the region→observer mapping
-//                     cache (regionObsCache, regionObsCacheTime).
-//
-//   6. hashSizeInfoMu (sync.Mutex)  — guards the cached hash-size-info
-//                     result (hashSizeInfoCache). Acquired independently or
-//                     under mu (in EvictStale).
-//
-// Nesting that occurs today:
-//   - IngestNew:               mu → cacheMu → channelsCacheMu  (1 → 2 → 3, OK)
-//   - IngestObservations:      mu → cacheMu                    (1 → 2, OK)
-//   - RunEviction/EvictStale:  mu → cacheMu → channelsCacheMu  (1 → 2 → 3, OK)
-//   - RunEviction/EvictStale:  mu → hashSizeInfoMu             (1 → 6, OK)
-//   - invalidateCachesFor:     cacheMu → channelsCacheMu       (2 → 3, OK)
-//
-// All other locks are acquired independently (no nesting).
-// When adding new lock acquisitions, respect this ordering.
 type PacketStore struct {
 	mu            sync.RWMutex
 	db            *DB
@@ -196,12 +157,6 @@ type PacketStore struct {
 	// Persisted neighbor graph for hop resolution at ingest time.
 	graph *NeighborGraph
 
-	// Async backfill state: set after backfillResolvedPathsAsync completes.
-	backfillComplete atomic.Bool
-	// Progress tracking for async backfill (total pending and processed so far).
-	backfillTotal     atomic.Int64 // set once at start of async backfill
-	backfillProcessed atomic.Int64
-
 	// Eviction config and stats
 	retentionHours   float64        // 0 = unlimited
 	maxMemoryMB      int            // 0 = unlimited
@@ -246,33 +201,8 @@ type cachedResult struct {
 	expiresAt time.Time
 }
 
-// cacheTTLSec extracts a duration from the cacheTTL config map.
-// Values may be float64 (from JSON) or int. Returns false if key is missing or non-positive.
-func cacheTTLSec(m map[string]interface{}, key string) (time.Duration, bool) {
-	v, ok := m[key]
-	if !ok {
-		return 0, false
-	}
-	var sec float64
-	switch n := v.(type) {
-	case float64:
-		sec = n
-	case int:
-		sec = float64(n)
-	case int64:
-		sec = float64(n)
-	default:
-		return 0, false
-	}
-	if sec <= 0 {
-		return 0, false
-	}
-	return time.Duration(sec * float64(time.Second)), true
-}
-
 // NewPacketStore creates a new empty packet store backed by db.
-// cacheTTLs is the optional cacheTTL map from config.json; keys are strings, values are seconds.
-func NewPacketStore(db *DB, cfg *PacketStoreConfig, cacheTTLs ...map[string]interface{}) *PacketStore {
+func NewPacketStore(db *DB, cfg *PacketStoreConfig) *PacketStore {
 	ps := &PacketStore{
 		db:            db,
 		packets:       make([]*StoreTx, 0, 65536),
@@ -293,7 +223,7 @@ func NewPacketStore(db *DB, cfg *PacketStoreConfig, cacheTTLs ...map[string]inte
 		distCache:     make(map[string]*cachedResult),
 		subpathCache:  make(map[string]*cachedResult),
 		rfCacheTTL:         15 * time.Second,
-		collisionCacheTTL: 3600 * time.Second,
+		collisionCacheTTL: 60 * time.Second,
 		invCooldown:       10 * time.Second,
 		spIndex:       make(map[string]int, 4096),
 		spTxIndex:     make(map[string][]*StoreTx, 4096),
@@ -303,16 +233,6 @@ func NewPacketStore(db *DB, cfg *PacketStoreConfig, cacheTTLs ...map[string]inte
 		ps.retentionHours = cfg.RetentionHours
 		ps.maxMemoryMB = cfg.MaxMemoryMB
 	}
-	// Wire cacheTTL config values to server-side cache durations.
-	if len(cacheTTLs) > 0 && cacheTTLs[0] != nil {
-		ct := cacheTTLs[0]
-		if v, ok := cacheTTLSec(ct, "analyticsHashSizes"); ok {
-			ps.collisionCacheTTL = v
-		}
-		if v, ok := cacheTTLSec(ct, "analyticsRF"); ok {
-			ps.rfCacheTTL = v
-		}
-	}
 	return ps
 }
 
@@ -2157,40 +2077,6 @@ func resolvePayloadTypeName(pt *int) string {
 	return fmt.Sprintf("UNK(%d)", *pt)
 }
 
-// nodeInResolvedPath checks whether a transmission's resolved_path contains
-// the target node's full pubkey. Returns true if at least one observation's
-// resolved_path includes targetPK (lowercased). Excludes transmissions where
-// resolved_path is nil/empty or the hop resolved to a different node.
-func nodeInResolvedPath(tx *StoreTx, targetPK string) bool {
-	// If no resolved_path data exists anywhere on this tx, we can't
-	// disambiguate — return true to keep it (avoid dropping old data).
-	hasAny := false
-
-	// Check the best observation's resolved_path (stored on tx directly).
-	if tx.ResolvedPath != nil && len(tx.ResolvedPath) > 0 {
-		hasAny = true
-		for _, rp := range tx.ResolvedPath {
-			if rp != nil && strings.ToLower(*rp) == targetPK {
-				return true
-			}
-		}
-	}
-	// Also check all observations in case a non-best observation resolved it.
-	for _, obs := range tx.Observations {
-		if obs.ResolvedPath == nil || len(obs.ResolvedPath) == 0 {
-			continue
-		}
-		hasAny = true
-		for _, rp := range obs.ResolvedPath {
-			if rp != nil && strings.ToLower(*rp) == targetPK {
-				return true
-			}
-		}
-	}
-	// No resolved_path data at all — can't disambiguate, keep the candidate.
-	return !hasAny
-}
-
 // txGetParsedPath returns cached parsed path hops, parsing on first call.
 func txGetParsedPath(tx *StoreTx) []string {
 	if tx.pathParsed {
@@ -4765,13 +4651,7 @@ func (s *PacketStore) computeAnalyticsHashSizes(region string) map[string]interf
 		regionObs = s.resolveRegionObservers(region)
 	}
 
-	allNodes, pm := s.getCachedNodesAndPM()
-
-	// Build pubkey→role map for filtering by node type.
-	nodeRoleByPK := make(map[string]string, len(allNodes))
-	for _, n := range allNodes {
-		nodeRoleByPK[n.PublicKey] = n.Role
-	}
+	_, pm := s.getCachedNodesAndPM()
 
 	distribution := map[string]int{"1": 0, "2": 0, "3": 0}
 	byHour := map[string]map[string]int{}
@@ -4848,11 +4728,9 @@ func (s *PacketStore) computeAnalyticsHashSizes(region string) map[string]interf
 						}
 					}
 					if byNode[pk] == nil {
-						role := nodeRoleByPK[pk] // empty if unknown
 						byNode[pk] = map[string]interface{}{
 							"hashSize": hashSize, "packets": 0,
 							"lastSeen": tx.FirstSeen, "name": name,
-							"role": role,
 						}
 					}
 					byNode[pk]["packets"] = byNode[pk]["packets"].(int) + 1
@@ -4944,7 +4822,7 @@ func (s *PacketStore) computeAnalyticsHashSizes(region string) map[string]interf
 			multiByteNodes = append(multiByteNodes, map[string]interface{}{
 				"name": data["name"], "hashSize": data["hashSize"],
 				"packets": data["packets"], "lastSeen": data["lastSeen"],
-				"pubkey": pk, "role": data["role"],
+				"pubkey": pk,
 			})
 		}
 	}
@@ -4952,13 +4830,9 @@ func (s *PacketStore) computeAnalyticsHashSizes(region string) map[string]interf
 		return multiByteNodes[i]["packets"].(int) > multiByteNodes[j]["packets"].(int)
 	})
 
-	// Distribution by repeaters: count unique REPEATER nodes per hash size
+	// Distribution by repeaters: count unique nodes per hash size
 	distributionByRepeaters := map[string]int{"1": 0, "2": 0, "3": 0}
 	for _, data := range byNode {
-		role, _ := data["role"].(string)
-		if !strings.Contains(strings.ToLower(role), "repeater") {
-			continue
-		}
 		hs := data["hashSize"].(int)
 		key := strconv.Itoa(hs)
 		distributionByRepeaters[key]++

cmd/server/types.go

@@ -68,8 +68,6 @@ type StatsResponse struct {
 	Commit             string     `json:"commit"`
 	BuildTime          string     `json:"buildTime"`
 	Counts             RoleCounts `json:"counts"`
-	Backfilling        bool       `json:"backfilling"`
-	BackfillProgress   float64    `json:"backfillProgress"`
 }
 
 // ─── Health ────────────────────────────────────────────────────────────────────

cmd/tui/.gitignore

@@ -0,0 +1 @@
+corescope-tui

cmd/tui/go.mod

@@ -0,0 +1,30 @@
+module github.com/corescope/tui
+
+go 1.22
+
+require (
+	github.com/charmbracelet/bubbletea v1.3.4
+	github.com/charmbracelet/lipgloss v1.1.0
+	github.com/gorilla/websocket v1.5.3
+)
+
+require (
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc // indirect
+	github.com/charmbracelet/x/ansi v0.8.0 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd // indirect
+	github.com/charmbracelet/x/term v0.2.1 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.16 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sync v0.11.0 // indirect
+	golang.org/x/sys v0.30.0 // indirect
+	golang.org/x/text v0.3.8 // indirect
+)

cmd/tui/go.sum

@@ -0,0 +1,47 @@
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbletea v1.3.4 h1:kCg7B+jSCFPLYRA52SDZjr51kG/fMUEoPoZrkaDHyoI=
+github.com/charmbracelet/bubbletea v1.3.4/go.mod h1:dtcUCyCGEX3g9tosuYiut3MXgY/Jsv9nKVdibKKRRXo=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.8.0 h1:9GTq3xq9caJW8ZrBTe0LIe2fvfLR/bYXKTx2llXn7xE=
+github.com/charmbracelet/x/ansi v0.8.0/go.mod h1:wdYl/ONOLHLIVmQaxbIYEC/cRKOQyjTkowiI4blgS9Q=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561 h1:MDc5xs78ZrZr3HMQugiXOAkSZtfTpbJLDr/lwfgO53E=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561/go.mod h1:cyybsKvd6eL0RnXn6p/Grxp8F5bW7iYuBgsNCOHpMYE=
+golang.org/x/sync v0.11.0 h1:GGz8+XQP4FvTTrjZPzNKTMFtSXH80RAzG+5ghFPgK9w=
+golang.org/x/sync v0.11.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=
+golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=

cmd/tui/main.go

@@ -0,0 +1,696 @@
+package main
+
+import (
+	"encoding/json"
+	"flag"
+	"fmt"
+	"io"
+	"math"
+	"net/http"
+	"net/url"
+	"os"
+	"sort"
+	"strings"
+	"sync"
+	"time"
+
+	tea "github.com/charmbracelet/bubbletea"
+	"github.com/charmbracelet/lipgloss"
+	"github.com/gorilla/websocket"
+)
+
+// --- Data types ---
+
+type ObserverSummary struct {
+	ObserverID   string   `json:"id"`
+	ObserverName *string  `json:"name"`
+	NoiseFloor   *float64 `json:"noise_floor"`
+	BatteryMv    *int     `json:"battery_mv"`
+	PacketCount  int      `json:"packet_count"`
+	LastSeen     string   `json:"last_seen"`
+}
+
+type Packet struct {
+	Timestamp    string
+	Type         string
+	ObserverName string
+	Hops         string
+	RSSI         string
+	SNR          string
+	ChannelText  string
+}
+
+// --- Messages ---
+
+type summaryMsg []ObserverSummary
+type summaryErrMsg struct{ err error }
+type packetMsg Packet
+type wsStatusMsg string
+type tickMsg time.Time
+type renderTickMsg time.Time
+
+// --- Model ---
+
+type view int
+
+const (
+	viewDashboard view = iota
+	viewLiveFeed
+)
+
+// ringBufferMax is the maximum number of packets kept in the live feed.
+const ringBufferMax = 500
+
+type model struct {
+	baseURL     string
+	currentView view
+	width       int
+	height      int
+
+	// Dashboard
+	observers   []ObserverSummary
+	lastRefresh time.Time
+	fetchErr    error
+
+	// Live feed — ring buffer with head/tail indices, no allocations in steady state.
+	ringBuf  [ringBufferMax]Packet
+	ringHead int // index of oldest element
+	ringLen  int // number of elements in the buffer
+	dirty    bool // true when new data arrived since last render tick
+	// wsMsgChan multiplexes packets and status updates from the WS goroutine
+	// into the bubbletea event loop.
+	wsMsgChan  chan tea.Msg
+	wsStatus   string
+	wsDone     chan struct{}
+	wsCloseOnce sync.Once
+}
+
+func initialModel(baseURL string) model {
+	return model{
+		baseURL:   strings.TrimRight(baseURL, "/"),
+		wsStatus:  "disconnected",
+		wsMsgChan: make(chan tea.Msg, 100),
+		wsDone:    make(chan struct{}),
+	}
+}
+
+// --- Styles ---
+
+var (
+	titleStyle  = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("69"))
+	greenStyle  = lipgloss.NewStyle().Foreground(lipgloss.Color("42"))
+	yellowStyle = lipgloss.NewStyle().Foreground(lipgloss.Color("226"))
+	redStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("196"))
+	dimStyle    = lipgloss.NewStyle().Foreground(lipgloss.Color("241"))
+	statusStyle = lipgloss.NewStyle().Background(lipgloss.Color("236")).Foreground(lipgloss.Color("252")).Padding(0, 1)
+	tabActive   = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("69")).Underline(true)
+	tabInactive = lipgloss.NewStyle().Foreground(lipgloss.Color("241"))
+	headerStyle = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("252"))
+)
+
+// --- Commands ---
+
+func fetchSummary(baseURL string) tea.Cmd {
+	return func() tea.Msg {
+		client := &http.Client{Timeout: 10 * time.Second}
+		resp, err := client.Get(baseURL + "/api/observers")
+		if err != nil {
+			return summaryErrMsg{err}
+		}
+		defer resp.Body.Close()
+		body, err := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
+		if err != nil {
+			return summaryErrMsg{err}
+		}
+		// The API returns {"observers": [...]}
+		var wrapper struct {
+			Observers []ObserverSummary `json:"observers"`
+		}
+		if err := json.Unmarshal(body, &wrapper); err != nil {
+			return summaryErrMsg{fmt.Errorf("json: %w (body: %.100s)", err, string(body))}
+		}
+		return summaryMsg(wrapper.Observers)
+	}
+}
+
+func tickEvery(d time.Duration) tea.Cmd {
+	return tea.Tick(d, func(t time.Time) tea.Msg {
+		return tickMsg(t)
+	})
+}
+
+// renderTick fires every 16ms (~60fps) to coalesce packet renders.
+func renderTick() tea.Cmd {
+	return tea.Tick(16*time.Millisecond, func(t time.Time) tea.Msg {
+		return renderTickMsg(t)
+	})
+}
+
+// listenForWSMsg waits for the next message from the WebSocket goroutine and
+// delivers it into the bubbletea event loop. Returns nil when the channel is
+// closed (program shutting down).
+func listenForWSMsg(ch <-chan tea.Msg) tea.Cmd {
+	return func() tea.Msg {
+		msg, ok := <-ch
+		if !ok {
+			return nil
+		}
+		return msg
+	}
+}
+
+// --- WebSocket goroutine ---
+
+// connectWS manages the WebSocket connection with exponential backoff reconnect.
+// It sends packetMsg and wsStatusMsg on msgChan. It returns when done is closed.
+func connectWS(baseURL string, msgChan chan<- tea.Msg, done <-chan struct{}) {
+	defer func() {
+		if r := recover(); r != nil {
+			select {
+			case msgChan <- wsStatusMsg(fmt.Sprintf("panic: %v", r)):
+			default:
+			}
+		}
+	}()
+
+	u, err := url.Parse(baseURL)
+	if err != nil {
+		select {
+		case msgChan <- wsStatusMsg("invalid url"):
+		case <-done:
+		}
+		return
+	}
+	scheme := "ws"
+	if u.Scheme == "https" {
+		scheme = "wss"
+	}
+	wsURL := scheme + "://" + u.Host + "/ws"
+
+	backoff := time.Second
+	maxBackoff := 30 * time.Second
+
+	for {
+		select {
+		case <-done:
+			return
+		default:
+		}
+
+		sendStatus(msgChan, done, "connecting...")
+		conn, _, err := websocket.DefaultDialer.Dial(wsURL, nil)
+		if err != nil {
+			sendStatus(msgChan, done, fmt.Sprintf("error: %v", err))
+			select {
+			case <-done:
+				return
+			case <-time.After(backoff):
+			}
+			backoff = time.Duration(math.Min(float64(backoff)*2, float64(maxBackoff)))
+			continue
+		}
+
+		sendStatus(msgChan, done, "connected")
+		backoff = time.Second
+
+		// readLoop reads messages until error or done.
+		// Ping/pong keepalive detects dead connections faster than relying on
+		// read deadline alone. We send pings every 30s; the pong handler resets
+		// the read deadline to 60s. If no pong arrives, ReadMessage times out.
+		func() {
+			defer conn.Close()
+
+			conn.SetReadDeadline(time.Now().Add(60 * time.Second))
+			conn.SetPongHandler(func(string) error {
+				conn.SetReadDeadline(time.Now().Add(60 * time.Second))
+				return nil
+			})
+
+			// Periodic ping goroutine
+			pingDone := make(chan struct{})
+			defer close(pingDone)
+			go func() {
+				ticker := time.NewTicker(30 * time.Second)
+				defer ticker.Stop()
+				for {
+					select {
+					case <-ticker.C:
+						if err := conn.WriteMessage(websocket.PingMessage, nil); err != nil {
+							return
+						}
+					case <-pingDone:
+						return
+					case <-done:
+						return
+					}
+				}
+			}()
+
+			for {
+				select {
+				case <-done:
+					// Send a graceful close frame before returning.
+					_ = conn.WriteMessage(
+						websocket.CloseMessage,
+						websocket.FormatCloseMessage(websocket.CloseNormalClosure, ""),
+					)
+					return
+				default:
+				}
+
+				// ReadMessage blocks until data arrives or the 60s read deadline
+				// expires. The pong handler resets the deadline on each pong.
+				// On timeout (dead connection), we break out and reconnect.
+				// We don't set a per-read deadline here — the pong handler and
+				// initial SetReadDeadline above manage it.
+				_, message, err := conn.ReadMessage()
+				if err != nil {
+					if websocket.IsCloseError(err, websocket.CloseNormalClosure) {
+						sendStatus(msgChan, done, "disconnected")
+						return
+					}
+					// Timeout is expected — just loop back to check done.
+					if netErr, ok := err.(*websocket.CloseError); ok {
+						sendStatus(msgChan, done, fmt.Sprintf("closed: %d", netErr.Code))
+						return
+					}
+					if isTimeoutError(err) {
+						continue
+					}
+					sendStatus(msgChan, done, "disconnected")
+					return
+				}
+
+				pkt := parseWSMessage(message)
+				if pkt != nil {
+					select {
+					case msgChan <- packetMsg(*pkt):
+					case <-done:
+						return
+					}
+				}
+			}
+		}()
+	}
+}
+
+// sendStatus sends a wsStatusMsg, respecting cancellation.
+func sendStatus(msgChan chan<- tea.Msg, done <-chan struct{}, status string) {
+	select {
+	case msgChan <- wsStatusMsg(status):
+	case <-done:
+	}
+}
+
+// isTimeoutError checks if an error is a network timeout (read deadline exceeded).
+func isTimeoutError(err error) bool {
+	// net.Error has a Timeout() method.
+	type timeout interface {
+		Timeout() bool
+	}
+	if t, ok := err.(timeout); ok {
+		return t.Timeout()
+	}
+	return false
+}
+
+// parseWSMessage parses a WebSocket broadcast frame.
+// The server sends: {"type":"packet","data":{...}} where data contains
+// top-level fields (observer_name, rssi, snr, timestamp, ...) plus
+// nested "decoded" (with header.payloadTypeName, payload) and "packet".
+func parseWSMessage(data []byte) *Packet {
+	var envelope map[string]interface{}
+	if err := json.Unmarshal(data, &envelope); err != nil {
+		return nil
+	}
+
+	// Unwrap the {"type":"packet","data":{...}} envelope
+	if t, _ := envelope["type"].(string); t != "packet" {
+		return nil // ignore non-packet messages (e.g. "status")
+	}
+	msg, ok := envelope["data"].(map[string]interface{})
+	if !ok {
+		return nil
+	}
+
+	pkt := &Packet{}
+
+	// Timestamp — prefer top-level, fall back to nested packet
+	if ts, ok := msg["timestamp"].(string); ok {
+		if t, err := time.Parse(time.RFC3339, ts); err == nil {
+			pkt.Timestamp = t.Format("15:04:05")
+		} else if len(ts) >= 8 {
+			pkt.Timestamp = ts[:8]
+		} else {
+			pkt.Timestamp = ts
+		}
+	}
+	if pkt.Timestamp == "" {
+		pkt.Timestamp = time.Now().Format("15:04:05")
+	}
+
+	// Type — from decoded.header.payloadTypeName (matches live.js)
+	if decoded, ok := msg["decoded"].(map[string]interface{}); ok {
+		if header, ok := decoded["header"].(map[string]interface{}); ok {
+			if t, ok := header["payloadTypeName"].(string); ok {
+				pkt.Type = t
+			}
+		}
+	}
+	if pkt.Type == "" {
+		pkt.Type = "UNKNOWN"
+	}
+
+	// Observer name
+	if name, ok := msg["observer_name"].(string); ok {
+		pkt.ObserverName = name
+	} else if id, ok := msg["observer_id"].(string); ok {
+		pkt.ObserverName = safePrefix(id, 8)
+	}
+
+	// Hops — from decoded.payload.hops or path
+	if decoded, ok := msg["decoded"].(map[string]interface{}); ok {
+		if payload, ok := decoded["payload"].(map[string]interface{}); ok {
+			if hops, ok := payload["hops"].(float64); ok {
+				pkt.Hops = fmt.Sprintf("%d", int(hops))
+			}
+		}
+	}
+
+	// RSSI / SNR — top-level fields
+	if rssi, ok := msg["rssi"].(float64); ok {
+		pkt.RSSI = fmt.Sprintf("%.0f", rssi)
+	}
+	if snr, ok := msg["snr"].(float64); ok {
+		pkt.SNR = fmt.Sprintf("%.1f", snr)
+	}
+
+	// Channel text — from decoded.payload
+	if decoded, ok := msg["decoded"].(map[string]interface{}); ok {
+		if payload, ok := decoded["payload"].(map[string]interface{}); ok {
+			ch := ""
+			if name, ok := payload["channel_name"].(string); ok {
+				ch = "#" + name
+			}
+			if text, ok := payload["text"].(string); ok {
+				if ch != "" {
+					pkt.ChannelText = ch + " " + truncate(text, 40)
+				} else {
+					pkt.ChannelText = truncate(text, 40)
+				}
+			}
+		}
+	}
+
+	return pkt
+}
+
+func truncate(s string, n int) string {
+	runes := []rune(s)
+	if len(runes) <= n {
+		return s
+	}
+	return string(runes[:n-1]) + "…"
+}
+
+// safePrefix returns the first n characters of s (rune-aware), or s if shorter.
+func safePrefix(s string, n int) string {
+	runes := []rune(s)
+	if len(runes) <= n {
+		return s
+	}
+	return string(runes[:n])
+}
+
+// --- Init / Update / View ---
+
+func (m model) Init() tea.Cmd {
+	go connectWS(m.baseURL, m.wsMsgChan, m.wsDone)
+
+	return tea.Batch(
+		fetchSummary(m.baseURL),
+		tickEvery(5*time.Second),
+		listenForWSMsg(m.wsMsgChan),
+		renderTick(),
+	)
+}
+
+func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+	switch msg := msg.(type) {
+	case tea.KeyMsg:
+		switch msg.String() {
+		case "q", "ctrl+c":
+			m.wsCloseOnce.Do(func() { close(m.wsDone) })
+			return m, tea.Quit
+		case "tab", "1":
+			if m.currentView == viewDashboard {
+				m.currentView = viewLiveFeed
+			} else {
+				m.currentView = viewDashboard
+			}
+		case "2":
+			m.currentView = viewLiveFeed
+		}
+
+	case tea.WindowSizeMsg:
+		m.width = msg.Width
+		m.height = msg.Height
+
+	case summaryMsg:
+		m.observers = []ObserverSummary(msg)
+		// Pre-sort by worst noise floor (highest = worst) so View doesn't sort on every render.
+		sort.Slice(m.observers, func(i, j int) bool {
+			return nfVal(m.observers[i].NoiseFloor) > nfVal(m.observers[j].NoiseFloor)
+		})
+		m.lastRefresh = time.Now()
+		m.fetchErr = nil
+
+	case summaryErrMsg:
+		m.fetchErr = msg.err
+
+	case tickMsg:
+		return m, tea.Batch(
+			fetchSummary(m.baseURL),
+			tickEvery(5*time.Second),
+			listenForWSMsg(m.wsMsgChan),
+		)
+
+	case wsStatusMsg:
+		m.wsStatus = string(msg)
+		return m, listenForWSMsg(m.wsMsgChan)
+
+	case packetMsg:
+		p := Packet(msg)
+		// Ring buffer: write at (head+len) % cap, no allocations.
+		if m.ringLen < ringBufferMax {
+			m.ringBuf[(m.ringHead+m.ringLen)%ringBufferMax] = p
+			m.ringLen++
+		} else {
+			// Overwrite oldest, advance head.
+			m.ringBuf[m.ringHead] = p
+			m.ringHead = (m.ringHead + 1) % ringBufferMax
+		}
+		m.dirty = true
+		return m, listenForWSMsg(m.wsMsgChan)
+
+	case renderTickMsg:
+		// 60fps render coalescing: bubbletea re-renders when Update returns.
+		// By ticking at 16ms, we batch all packets that arrived between ticks
+		// into a single View() call instead of re-rendering per packet.
+		if m.dirty {
+			m.dirty = false
+		}
+		return m, renderTick()
+	}
+
+	// Always keep the WS listener running, even for unhandled messages.
+	return m, listenForWSMsg(m.wsMsgChan)
+}
+
+func (m model) View() string {
+	var b strings.Builder
+
+	// Title
+	b.WriteString(titleStyle.Render("🍄 CoreScope TUI"))
+	b.WriteString("\n")
+
+	// Tabs
+	dash := tabInactive.Render("[1:Dashboard]")
+	live := tabInactive.Render("[2:Live Feed]")
+	if m.currentView == viewDashboard {
+		dash = tabActive.Render("[1:Dashboard]")
+	} else {
+		live = tabActive.Render("[2:Live Feed]")
+	}
+	b.WriteString(dash + "  " + live + "\n\n")
+
+	// Content
+	switch m.currentView {
+	case viewDashboard:
+		b.WriteString(m.viewDashboard())
+	case viewLiveFeed:
+		b.WriteString(m.viewLiveFeed())
+	}
+
+	// Status bar
+	b.WriteString("\n")
+	wsIcon := "●"
+	wsColor := redStyle
+	if m.wsStatus == "connected" {
+		wsColor = greenStyle
+	} else if m.wsStatus == "connecting..." {
+		wsColor = yellowStyle
+	}
+	status := fmt.Sprintf(" WS: %s %s │ View: %s │ %s │ q:quit Tab:switch",
+		wsColor.Render(wsIcon), m.wsStatus,
+		viewName(m.currentView),
+		m.baseURL,
+	)
+	b.WriteString(statusStyle.Render(status))
+
+	return b.String()
+}
+
+func viewName(v view) string {
+	if v == viewDashboard {
+		return "Dashboard"
+	}
+	return "Live Feed"
+}
+
+func (m model) viewDashboard() string {
+	var b strings.Builder
+
+	if m.fetchErr != nil {
+		b.WriteString(redStyle.Render(fmt.Sprintf("Error: %v", m.fetchErr)))
+		b.WriteString("\n\n")
+	}
+
+	refreshStr := ""
+	if !m.lastRefresh.IsZero() {
+		refreshStr = m.lastRefresh.Format("15:04:05")
+	}
+	b.WriteString(fmt.Sprintf("Observers: %d │ Last refresh: %s\n\n",
+		len(m.observers), refreshStr))
+
+	// Header
+	b.WriteString(headerStyle.Render(fmt.Sprintf("%-24s %8s %10s %8s %10s",
+		"Observer", "NF(dBm)", "Battery", "Packets", "Last Seen")))
+	b.WriteString("\n")
+	b.WriteString(dimStyle.Render(strings.Repeat("─", 68)))
+	b.WriteString("\n")
+
+	for _, o := range m.observers {
+		name := safePrefix(o.ObserverID, 8)
+		if o.ObserverName != nil && *o.ObserverName != "" {
+			name = truncate(*o.ObserverName, 24)
+		}
+
+		nf := fmtNF(o.NoiseFloor)
+		batt := "—"
+		if o.BatteryMv != nil {
+			batt = fmt.Sprintf("%dmV", *o.BatteryMv)
+		}
+		lastSeen := "—"
+		if o.LastSeen != "" {
+			if t, err := time.Parse(time.RFC3339, o.LastSeen); err == nil {
+				lastSeen = time.Since(t).Truncate(time.Second).String() + " ago"
+				if time.Since(t) < time.Minute {
+					lastSeen = "just now"
+				}
+			}
+		}
+
+		// Color code NF
+		nfStyle := greenStyle
+		if o.NoiseFloor != nil {
+			if *o.NoiseFloor > -85 {
+				nfStyle = redStyle
+			} else if *o.NoiseFloor > -100 {
+				nfStyle = yellowStyle
+			}
+		}
+
+		line := fmt.Sprintf("%-24s %8s %10s %8d %10s",
+			name, nfStyle.Render(nf), batt, o.PacketCount, lastSeen)
+		b.WriteString(line + "\n")
+	}
+
+	return b.String()
+}
+
+func nfVal(nf *float64) float64 {
+	if nf == nil {
+		return -999
+	}
+	return *nf
+}
+
+func fmtNF(nf *float64) string {
+	if nf == nil {
+		return "—"
+	}
+	return fmt.Sprintf("%.1f", *nf)
+}
+
+func (m model) viewLiveFeed() string {
+	var b strings.Builder
+
+	b.WriteString(fmt.Sprintf("Packets: %d/%d │ WS: %s\n\n", m.ringLen, ringBufferMax, m.wsStatus))
+
+	b.WriteString(headerStyle.Render(fmt.Sprintf("%-10s %-10s %-20s %5s %6s %6s  %s",
+		"Time", "Type", "Observer", "Hops", "RSSI", "SNR", "Channel/Text")))
+	b.WriteString("\n")
+	b.WriteString(dimStyle.Render(strings.Repeat("─", 85)))
+	b.WriteString("\n")
+
+	// Show last N packets that fit the screen
+	maxLines := 20
+	if m.height > 10 {
+		maxLines = m.height - 10
+	}
+	// Calculate visible range from the ring buffer (most recent packets).
+	visible := m.ringLen
+	if visible > maxLines {
+		visible = maxLines
+	}
+	startIdx := m.ringLen - visible // offset from oldest
+
+	for i := 0; i < visible; i++ {
+		p := m.ringBuf[(m.ringHead+startIdx+i)%ringBufferMax]
+		typeStyle := dimStyle
+		switch p.Type {
+		case "ADVERT":
+			typeStyle = greenStyle
+		case "GRP_TXT", "TXT_MSG":
+			typeStyle = yellowStyle
+		case "REQ":
+			typeStyle = redStyle
+		}
+
+		line := fmt.Sprintf("%-10s %s %-20s %5s %6s %6s  %s",
+			dimStyle.Render(p.Timestamp),
+			typeStyle.Render(fmt.Sprintf("%-10s", p.Type)),
+			truncate(p.ObserverName, 20),
+			p.Hops, p.RSSI, p.SNR,
+			dimStyle.Render(p.ChannelText),
+		)
+		b.WriteString(line + "\n")
+	}
+
+	return b.String()
+}
+
+// --- Main ---
+
+func main() {
+	urlFlag := flag.String("url", "http://localhost:3000", "CoreScope server URL")
+	flag.Parse()
+
+	m := initialModel(*urlFlag)
+	p := tea.NewProgram(m, tea.WithAltScreen())
+	if _, err := p.Run(); err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+		os.Exit(1)
+	}
+}

config.example.json

@@ -8,15 +8,13 @@
   },
   "https": {
     "cert": "/path/to/cert.pem",
-    "key": "/path/to/key.pem",
-    "_comment": "TLS cert/key paths for direct HTTPS. Most deployments use Caddy (included in Docker) for auto-TLS instead."
+    "key": "/path/to/key.pem"
   },
   "branding": {
     "siteName": "CoreScope",
     "tagline": "Real-time MeshCore LoRa mesh network analyzer",
     "logoUrl": null,
-    "faviconUrl": null,
-    "_comment": "Customize site name, tagline, logo, and favicon. logoUrl/faviconUrl can be absolute URLs or relative paths."
+    "faviconUrl": null
   },
   "theme": {
     "accent": "#4a9eff",
@@ -25,75 +23,38 @@
     "navBg2": "#1a1a2e",
     "statusGreen": "#45644c",
     "statusYellow": "#b08b2d",
-    "statusRed": "#b54a4a",
-    "_comment": "CSS color overrides. Use the in-app Theme Customizer for live preview, then export values here."
+    "statusRed": "#b54a4a"
   },
   "nodeColors": {
     "repeater": "#dc2626",
     "companion": "#2563eb",
     "room": "#16a34a",
     "sensor": "#d97706",
-    "observer": "#8b5cf6",
-    "_comment": "Marker/badge colors per node role. Used on map, nodes list, and live feed."
+    "observer": "#8b5cf6"
   },
   "home": {
     "heroTitle": "CoreScope",
     "heroSubtitle": "Find your nodes to start monitoring them.",
     "steps": [
-      {
-        "emoji": "\ud83d\udce1",
-        "title": "Connect",
-        "description": "Link your node to the mesh"
-      },
-      {
-        "emoji": "\ud83d\udd0d",
-        "title": "Monitor",
-        "description": "Watch packets flow in real-time"
-      },
-      {
-        "emoji": "\ud83d\udcca",
-        "title": "Analyze",
-        "description": "Understand your network's health"
-      }
+      { "emoji": "📡", "title": "Connect", "description": "Link your node to the mesh" },
+      { "emoji": "🔍", "title": "Monitor", "description": "Watch packets flow in real-time" },
+      { "emoji": "📊", "title": "Analyze", "description": "Understand your network's health" }
     ],
     "checklist": [
-      {
-        "question": "How do I add my node?",
-        "answer": "Search for your node name or paste your public key."
-      },
-      {
-        "question": "What regions are covered?",
-        "answer": "Check the map page to see active observers and nodes."
-      }
+      { "question": "How do I add my node?", "answer": "Search for your node name or paste your public key." },
+      { "question": "What regions are covered?", "answer": "Check the map page to see active observers and nodes." }
     ],
     "footerLinks": [
-      {
-        "label": "\ud83d\udce6 Packets",
-        "url": "#/packets"
-      },
-      {
-        "label": "\ud83d\uddfa\ufe0f Network Map",
-        "url": "#/map"
-      },
-      {
-        "label": "\ud83d\udd34 Live",
-        "url": "#/live"
-      },
-      {
-        "label": "\ud83d\udce1 All Nodes",
-        "url": "#/nodes"
-      },
-      {
-        "label": "\ud83d\udcac Channels",
-        "url": "#/channels"
-      }
-    ],
-    "_comment": "Customize the landing page hero, onboarding steps, FAQ, and footer links."
+      { "label": "📦 Packets", "url": "#/packets" },
+      { "label": "🗺️ Network Map", "url": "#/map" },
+      { "label": "🔴 Live", "url": "#/live" },
+      { "label": "📡 All Nodes", "url": "#/nodes" },
+      { "label": "💬 Channels", "url": "#/channels" }
+    ]
   },
   "mqtt": {
     "broker": "mqtt://localhost:1883",
-    "topic": "meshcore/+/+/packets",
-    "_comment": "Legacy single-broker config. Prefer mqttSources[] for multiple brokers."
+    "topic": "meshcore/+/+/packets"
   },
   "mqttSources": [
     {
@@ -189,26 +150,11 @@
     "timezone": "local",
     "formatPreset": "iso",
     "customFormat": "",
-    "allowCustomFormat": false,
-    "_comment": "defaultMode: ago|local|iso. timezone: local|utc. formatPreset: iso|us|eu. customFormat: strftime-style (requires allowCustomFormat: true)."
+    "allowCustomFormat": false
   },
   "packetStore": {
     "maxMemoryMB": 1024,
     "estimatedPacketBytes": 450,
     "_comment": "In-memory packet store. maxMemoryMB caps RAM usage. All packets loaded on startup, served from RAM."
-  },
-  "resolvedPath": {
-    "backfillHours": 24,
-    "_comment": "How far back (hours) the async backfill scans for observations with NULL resolved_path. Default: 24. Set higher to backfill older data, lower to speed up startup."
-  },
-  "neighborGraph": {
-    "maxAgeDays": 5,
-    "_comment": "Neighbor edges older than this many days are pruned on startup and daily. Default: 5."
-  },
-  "_comment_mqttSources": "Each source connects to an MQTT broker. topics: what to subscribe to. iataFilter: only ingest packets from these regions (optional).",
-  "_comment_channelKeys": "Hex keys for decrypting channel messages. Key name = channel display name. public channel key is well-known.",
-  "_comment_hashChannels": "Channel names whose keys are derived via SHA256. Key = SHA256(name)[:16]. Listed here so the ingestor can auto-derive keys.",
-  "_comment_defaultRegion": "IATA code shown by default in region filters.",
-  "_comment_mapDefaults": "Initial map center [lat, lon] and zoom level.",
-  "_comment_regions": "IATA code to display name mapping. Packets are tagged with region codes by MQTT topic structure."
-}
+  }
+}

docker-compose.example.yml

@@ -1,20 +0,0 @@
-# CoreScope — simple deployment using pre-built image from GHCR
-# Usage: docker compose -f docker-compose.example.yml up -d
-# Docs:  https://github.com/Kpa-clawbot/CoreScope/blob/master/DEPLOY.md
-
-services:
-  corescope:
-    image: ghcr.io/kpa-clawbot/corescope:latest
-    ports:
-      - "${HTTP_PORT:-80}:80"
-    volumes:
-      - ${DATA_DIR:-./data}:/app/data
-    environment:
-      - DISABLE_CADDY=${DISABLE_CADDY:-true}
-      - DISABLE_MOSQUITTO=${DISABLE_MOSQUITTO:-false}
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD", "wget", "-qO-", "http://localhost:3000/api/stats"]
-      interval: 30s
-      timeout: 5s
-      retries: 3

docker-compose.staging.yml

@@ -15,11 +15,15 @@ services:
     restart: unless-stopped
     stop_grace_period: 30s
     stop_signal: SIGTERM
+    deploy:
+      resources:
+        limits:
+          memory: 3g
     extra_hosts:
       - "host.docker.internal:host-gateway"
     ports:
-      - "${STAGING_GO_HTTP_PORT:-80}:80"
-      - "${STAGING_GO_MQTT_PORT:-1883}:1883"
+      - "${STAGING_GO_HTTP_PORT:-82}:80"
+      - "${STAGING_GO_MQTT_PORT:-1885}:1883"
       - "6060:6060"   # pprof server
       - "6061:6061"   # pprof ingestor
     volumes:

docker/entrypoint-go.sh

@@ -15,16 +15,9 @@ if [ -f /app/data/theme.json ]; then
 fi
 
 SUPERVISORD_CONF="/etc/supervisor/conf.d/supervisord.conf"
-if [ "${DISABLE_MOSQUITTO:-false}" = "true" ] && [ "${DISABLE_CADDY:-false}" = "true" ]; then
-  echo "[config] internal MQTT broker disabled (DISABLE_MOSQUITTO=true)"
-  echo "[config] Caddy reverse proxy disabled (DISABLE_CADDY=true)"
-  SUPERVISORD_CONF="/etc/supervisor/conf.d/supervisord-no-mosquitto-no-caddy.conf"
-elif [ "${DISABLE_MOSQUITTO:-false}" = "true" ]; then
+if [ "${DISABLE_MOSQUITTO:-false}" = "true" ]; then
   echo "[config] internal MQTT broker disabled (DISABLE_MOSQUITTO=true)"
   SUPERVISORD_CONF="/etc/supervisor/conf.d/supervisord-no-mosquitto.conf"
-elif [ "${DISABLE_CADDY:-false}" = "true" ]; then
-  echo "[config] Caddy reverse proxy disabled (DISABLE_CADDY=true)"
-  SUPERVISORD_CONF="/etc/supervisor/conf.d/supervisord-no-caddy.conf"
 fi
 
 exec /usr/bin/supervisord -c "$SUPERVISORD_CONF"

docker/supervisord-go-no-caddy.conf

@@ -1,43 +0,0 @@
-[supervisord]
-nodaemon=true
-user=root
-logfile=/dev/stdout
-logfile_maxbytes=0
-pidfile=/var/run/supervisord.pid
-
-[program:mosquitto]
-command=/usr/sbin/mosquitto -c /etc/mosquitto/mosquitto.conf
-autostart=true
-autorestart=true
-stdout_logfile=/dev/stdout
-stdout_logfile_maxbytes=0
-stderr_logfile=/dev/stderr
-stderr_logfile_maxbytes=0
-
-[program:corescope-ingestor]
-command=/app/corescope-ingestor -config /app/config.json
-directory=/app
-autostart=true
-autorestart=true
-startretries=10
-startsecs=2
-stopsignal=TERM
-stopwaitsecs=20
-stdout_logfile=/dev/stdout
-stdout_logfile_maxbytes=0
-stderr_logfile=/dev/stderr
-stderr_logfile_maxbytes=0
-
-[program:corescope-server]
-command=/app/corescope-server -config-dir /app -db /app/data/meshcore.db -public /app/public -port 3000
-directory=/app
-autostart=true
-autorestart=true
-startretries=10
-startsecs=2
-stopsignal=TERM
-stopwaitsecs=20
-stdout_logfile=/dev/stdout
-stdout_logfile_maxbytes=0
-stderr_logfile=/dev/stderr
-stderr_logfile_maxbytes=0

docker/supervisord-go-no-mosquitto-no-caddy.conf

@@ -1,34 +0,0 @@
-[supervisord]
-nodaemon=true
-user=root
-logfile=/dev/stdout
-logfile_maxbytes=0
-pidfile=/var/run/supervisord.pid
-
-[program:corescope-ingestor]
-command=/app/corescope-ingestor -config /app/config.json
-directory=/app
-autostart=true
-autorestart=true
-startretries=10
-startsecs=2
-stopsignal=TERM
-stopwaitsecs=20
-stdout_logfile=/dev/stdout
-stdout_logfile_maxbytes=0
-stderr_logfile=/dev/stderr
-stderr_logfile_maxbytes=0
-
-[program:corescope-server]
-command=/app/corescope-server -config-dir /app -db /app/data/meshcore.db -public /app/public -port 3000
-directory=/app
-autostart=true
-autorestart=true
-startretries=10
-startsecs=2
-stopsignal=TERM
-stopwaitsecs=20
-stdout_logfile=/dev/stdout
-stdout_logfile_maxbytes=0
-stderr_logfile=/dev/stderr
-stderr_logfile_maxbytes=0

docs/deployment.md

@@ -1,447 +0,0 @@
-# CoreScope Deployment Guide
-
-Comprehensive guide to deploying and operating CoreScope. For a quick start, see [DEPLOY.md](../DEPLOY.md).
-
-## Table of Contents
-
-- [System Requirements](#system-requirements)
-- [Docker Deployment](#docker-deployment)
-- [Configuration Reference](#configuration-reference)
-- [MQTT Setup](#mqtt-setup)
-- [TLS / HTTPS](#tls--https)
-- [Monitoring & Health Checks](#monitoring--health-checks)
-- [Backup & Restore](#backup--restore)
-- [Troubleshooting](#troubleshooting)
-
----
-
-## System Requirements
-
-| Resource | Minimum | Recommended |
-|----------|---------|-------------|
-| RAM | 256 MB | 512 MB+ |
-| Disk | 500 MB (image + DB) | 2 GB+ for long-term data |
-| CPU | 1 core | 2+ cores |
-| Architecture | `linux/amd64`, `linux/arm64` | — |
-| Docker | 20.10+ | Latest stable |
-
-CoreScope runs well on Raspberry Pi 4/5 (ARM64). The Go server uses ~300 MB RAM for 56K+ packets.
-
----
-
-## Docker Deployment
-
-### Quick Start (one command)
-
-```bash
-docker run -d --name corescope \
-  -p 80:80 \
-  -v corescope-data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:latest
-```
-
-Open `http://localhost` — you'll see an empty dashboard ready to receive packets.
-
-No `config.json` is required. The server starts with sensible defaults:
-- HTTP on port 3000 (Caddy proxies port 80 → 3000 internally)
-- Internal Mosquitto MQTT broker on port 1883
-- Ingestor connects to `mqtt://localhost:1883` automatically
-- SQLite database at `/app/data/meshcore.db`
-
-### Docker Compose (recommended for production)
-
-Download the example compose file:
-
-```bash
-curl -sL https://raw.githubusercontent.com/Kpa-clawbot/CoreScope/master/docker-compose.example.yml \
-  -o docker-compose.yml
-docker compose up -d
-```
-
-#### Compose environment variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `HTTP_PORT` | `80` | Host port for the web UI |
-| `DATA_DIR` | `./data` | Host path for persistent data |
-| `DISABLE_MOSQUITTO` | `false` | Set `true` to use an external MQTT broker |
-
-### Image tags
-
-| Tag | Use case |
-|-----|----------|
-| `v3.4.1` | Pinned release — recommended for production |
-| `v3.4` | Latest patch in the v3.4.x series |
-| `v3` | Latest minor+patch in v3.x |
-| `latest` | Latest release tag |
-| `edge` | Built from master on every push — unstable |
-
-### Updating
-
-```bash
-docker compose pull
-docker compose up -d
-```
-
-For `docker run` users:
-
-```bash
-docker pull ghcr.io/kpa-clawbot/corescope:latest
-docker stop corescope && docker rm corescope
-docker run -d --name corescope ... # same flags as before
-```
-
-Data is preserved in the volume — updates are non-destructive.
-
----
-
-## Configuration Reference
-
-CoreScope uses a layered configuration system (highest priority wins):
-
-1. **Environment variables** — `MQTT_BROKER`, `DB_PATH`, etc.
-2. **`/app/data/config.json`** — full config file (volume-mounted)
-3. **Built-in defaults** — work out of the box with no config
-
-### Environment variable overrides
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `MQTT_BROKER` | `mqtt://localhost:1883` | MQTT broker URL (overrides config file) |
-| `MQTT_TOPIC` | `meshcore/#` | MQTT topic subscription pattern |
-| `DB_PATH` | `data/meshcore.db` | SQLite database path |
-| `DISABLE_MOSQUITTO` | `false` | Skip the internal Mosquitto broker |
-
-### config.json
-
-For advanced configuration, create a `config.json` and mount it at `/app/data/config.json`:
-
-```bash
-docker run -d --name corescope \
-  -p 80:80 \
-  -v corescope-data:/app/data \
-  -v ./config.json:/app/data/config.json:ro \
-  ghcr.io/kpa-clawbot/corescope:latest
-```
-
-See `config.example.json` in the repository for all available options including:
-- MQTT sources (multiple brokers)
-- Channel encryption keys
-- Branding and theming
-- Health thresholds
-- Region filters
-- Retention policies
-- Geo-filtering
-
----
-
-## MQTT Setup
-
-CoreScope receives MeshCore packets via MQTT. The container ships with an internal Mosquitto broker — no setup needed for basic use.
-
-### Internal broker (default)
-
-The built-in Mosquitto broker listens on port 1883 inside the container. Point your MeshCore gateways at it:
-
-```bash
-# Expose MQTT port for external gateways
-docker run -d --name corescope \
-  -p 80:80 -p 1883:1883 \
-  -v corescope-data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:latest
-```
-
-### External broker
-
-To use your own MQTT broker (Mosquitto, EMQX, HiveMQ, etc.):
-
-1. Disable the internal broker:
-   ```bash
-   -e DISABLE_MOSQUITTO=true
-   ```
-
-2. Point the ingestor at your broker:
-   ```bash
-   -e MQTT_BROKER=mqtt://your-broker:1883
-   ```
-
-   Or via `config.json`:
-   ```json
-   {
-     "mqttSources": [
-       {
-         "name": "my-broker",
-         "broker": "mqtt://your-broker:1883",
-         "username": "user",
-         "password": "pass",
-         "topics": ["meshcore/#"]
-       }
-     ]
-   }
-   ```
-
-### Multiple brokers
-
-CoreScope can connect to multiple MQTT brokers simultaneously:
-
-```json
-{
-  "mqttSources": [
-    {
-      "name": "local",
-      "broker": "mqtt://localhost:1883",
-      "topics": ["meshcore/#"]
-    },
-    {
-      "name": "remote",
-      "broker": "mqtts://remote-broker:8883",
-      "username": "reader",
-      "password": "secret",
-      "topics": ["meshcore/+/+/packets"]
-    }
-  ]
-}
-```
-
-### MQTT topic format
-
-MeshCore gateways typically publish to `meshcore/<gateway>/<region>/packets`. The default subscription `meshcore/#` catches all of them.
-
----
-
-## TLS / HTTPS
-
-### Option 1: External reverse proxy (recommended)
-
-Run CoreScope behind nginx, Traefik, or Cloudflare Tunnel for TLS termination:
-
-```nginx
-# nginx example
-server {
-    listen 443 ssl;
-    server_name corescope.example.com;
-
-    ssl_certificate /etc/ssl/certs/corescope.pem;
-    ssl_certificate_key /etc/ssl/private/corescope.key;
-
-    location / {
-        proxy_pass http://localhost:80;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_set_header Host $host;
-    }
-}
-```
-
-The `Upgrade` and `Connection` headers are required for WebSocket support.
-
-### Option 2: Built-in Caddy (auto-TLS)
-
-The container includes Caddy for automatic Let's Encrypt certificates:
-
-1. Create a Caddyfile:
-   ```
-   corescope.example.com {
-     reverse_proxy localhost:3000
-   }
-   ```
-
-2. Mount it and expose TLS ports:
-   ```bash
-   docker run -d --name corescope \
-     -p 80:80 -p 443:443 \
-     -v corescope-data:/app/data \
-     -v caddy-certs:/data/caddy \
-     -v ./Caddyfile:/etc/caddy/Caddyfile:ro \
-     ghcr.io/kpa-clawbot/corescope:latest
-   ```
-
-Caddy handles certificate issuance and renewal automatically.
-
----
-
-## API Documentation
-
-CoreScope auto-generates an OpenAPI 3.0 specification from its route definitions. The spec is always in sync with the running server — no manual maintenance required.
-
-### Endpoints
-
-| URL | Description |
-|-----|-------------|
-| `/api/spec` | OpenAPI 3.0 JSON schema — machine-readable API definition |
-| `/api/docs` | Interactive Swagger UI — browse and test all 40+ endpoints |
-
-### Usage
-
-**Browse the API interactively:**
-```
-http://your-instance/api/docs
-```
-
-**Fetch the spec programmatically:**
-```bash
-curl http://your-instance/api/spec | jq .
-```
-
-**For bot/integration developers:** The spec includes all request parameters, response schemas, and example values. Import it into Postman, Insomnia, or any OpenAPI-compatible tool.
-
-### Public instance
-The live instance at [analyzer.00id.net](https://analyzer.00id.net) has all API endpoints publicly accessible:
-- Spec: [analyzer.00id.net/api/spec](https://analyzer.00id.net/api/spec)
-- Docs: [analyzer.00id.net/api/docs](https://analyzer.00id.net/api/docs)
-
----
-
-## Monitoring & Health Checks
-
-### Docker health check
-
-The container includes a built-in health check that hits `/api/stats`:
-
-```bash
-docker inspect --format='{{.State.Health.Status}}' corescope
-```
-
-Docker reports `healthy` or `unhealthy` automatically. The check runs every 30 seconds.
-
-### Manual health check
-
-```bash
-curl -f http://localhost/api/stats
-```
-
-Returns JSON with packet counts, node counts, and version info:
-
-```json
-{
-  "totalPackets": 56234,
-  "totalNodes": 142,
-  "totalObservers": 12,
-  "packetsLastHour": 830,
-  "packetsLast24h": 19644,
-  "engine": "go",
-  "version": "v3.4.1"
-}
-```
-
-### Log monitoring
-
-```bash
-# All logs
-docker compose logs -f
-
-# Server only
-docker compose logs -f | grep '\[server\]'
-
-# Ingestor only
-docker compose logs -f | grep '\[ingestor\]'
-```
-
-### Resource monitoring
-
-```bash
-docker stats corescope
-```
-
----
-
-## Backup & Restore
-
-### Backup
-
-All persistent data lives in `/app/data`. The critical file is the SQLite database:
-
-```bash
-# Copy from the Docker volume
-docker cp corescope:/app/data/meshcore.db ./backup-$(date +%Y%m%d).db
-
-# Or if using a bind mount
-cp ./data/meshcore.db ./backup-$(date +%Y%m%d).db
-```
-
-Optional files to back up:
-- `config.json` — custom configuration
-- `theme.json` — custom theme/branding
-
-### Restore
-
-```bash
-# Stop the container
-docker stop corescope
-
-# Replace the database
-docker cp ./backup.db corescope:/app/data/meshcore.db
-
-# Restart
-docker start corescope
-```
-
-### Automated backups
-
-```bash
-# cron: daily backup at 3 AM, keep 7 days
-0 3 * * * docker cp corescope:/app/data/meshcore.db /backups/corescope-$(date +\%Y\%m\%d).db && find /backups -name "corescope-*.db" -mtime +7 -delete
-```
-
----
-
-## Troubleshooting
-
-### Container starts but dashboard is empty
-
-This is normal on first start with no MQTT sources configured. The dashboard shows data once packets arrive via MQTT. Either:
-- Point a MeshCore gateway at the container's MQTT broker (port 1883)
-- Configure an external MQTT source in `config.json`
-
-### "no MQTT connections established" in logs
-
-The ingestor couldn't connect to any MQTT broker. Check:
-1. Is the internal Mosquitto running? (`DISABLE_MOSQUITTO` should be `false`)
-2. Is the external broker reachable? Test with `mosquitto_sub -h broker -t meshcore/#`
-3. Are credentials correct in `config.json`?
-
-### WebSocket disconnects / real-time updates stop
-
-If behind a reverse proxy, ensure WebSocket upgrade headers are forwarded:
-```nginx
-proxy_http_version 1.1;
-proxy_set_header Upgrade $http_upgrade;
-proxy_set_header Connection "upgrade";
-```
-
-Also check proxy timeouts — set them to at least 300s for long-lived WebSocket connections.
-
-### High memory usage
-
-The in-memory packet store grows with retained packets. Configure retention limits in `config.json`:
-
-```json
-{
-  "packetStore": {
-    "retentionHours": 24,
-    "maxMemoryMB": 512
-  },
-  "retention": {
-    "nodeDays": 7,
-    "packetDays": 30
-  }
-}
-```
-
-### Database locked errors
-
-SQLite doesn't support concurrent writers well. Ensure only one CoreScope instance accesses the database file. If running multiple containers, each needs its own database.
-
-### Container unhealthy
-
-Check logs: `docker compose logs --tail 50`. Common causes:
-- Port 3000 already in use inside the container
-- Database file permissions (must be writable by the container user)
-- Corrupted database — restore from backup
-
-### ARM / Raspberry Pi issues
-
-- Use `linux/arm64` images (Pi 4 and 5). Pi 3 (armv7) is not supported.
-- First pull may be slow — the multi-arch manifest selects the right image automatically.
-- If memory is tight, set `packetStore.maxMemoryMB` to limit RAM usage.

docs/release-notes/v3.5.0.md

@@ -1,135 +0,0 @@
-# CoreScope v3.5.0 🚀
-
-The "stop building from source and start analyzing your mesh" release. 95 commits.
-
----
-
-## 🐳 Pre-built Docker Images
-
-CoreScope now ships as a ready-to-run Docker image on GitHub Container Registry. No cloning, no building, no dependencies — just pull and run.
-
-```bash
-docker run -d --name corescope -p 80:80 -p 443:443 -p 1883:1883 \
-  -v corescope-data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:v3.5.0
-```
-
-**Using HTTPS with a custom domain?** Mount your Caddyfile and certs directory:
-```bash
-docker run -d --name corescope -p 80:80 -p 443:443 -p 1883:1883 \
-  -v /your/data:/app/data \
-  -v /your/Caddyfile:/etc/caddy/Caddyfile:ro \
-  -v /your/caddy-data:/data/caddy \
-  ghcr.io/kpa-clawbot/corescope:v3.5.0
-```
-Caddy auto-provisions Let's Encrypt certs. Your Caddyfile just needs:
-```
-yourdomain.example.com {
-    reverse_proxy localhost:3000
-}
-```
-
-That's it. Zero config required — MQTT broker, Caddy HTTPS, and SQLite are built in.
-
-**Already running CoreScope?**
-```bash
-# 1. Find your running container name
-docker ps --format '{{.Names}}'
-
-# 2. Stop and remove it
-docker stop <container-name> && docker rm <container-name>
-
-# 3. Pull the pre-built image
-docker pull ghcr.io/kpa-clawbot/corescope:v3.5.0
-
-# 4. Run with your existing data directory
-docker run -d --name corescope -p 80:80 -p 443:443 -p 1883:1883 \
-  -v /your/data:/app/data \
-  -v /your/Caddyfile:/etc/caddy/Caddyfile:ro \
-  -v /your/caddy-data:/data/caddy \
-  ghcr.io/kpa-clawbot/corescope:v3.5.0
-```
-Your data volume stays. Nothing to migrate.
-
-Tags: `v3.5.0` (this release) · `latest` (latest tagged release) · `edge` (master tip, for testing). Env: `DISABLE_CADDY=true` / `DISABLE_MOSQUITTO=true` if you bring your own.
-
----
-
-## ⚡ 83% Faster
-
-35 performance commits. Packets endpoint p50 dropped from 16.7ms → 2.7ms. Server now serves HTTP within 2 minutes on *any* DB size — async background backfill means you're never staring at a loading screen. N+1 API calls killed everywhere. Prefix map memory cut 10x. WebSocket renders batched via rAF.
-
----
-
-## 🔬 RF Health Dashboard
-
-New Analytics tab. Per-observer noise floor as color-coded columns (green/yellow/red), airtime utilization, error rates, battery levels. Click any observer for the full breakdown. Region-filterable. This is the beginning of making CoreScope more than just a packet viewer.
-
----
-
-## 🗺️ See Where Traces Actually Go
-
-Send a trace → watch it on the live map. Solid animated line shows how far it got. Dashed ghost shows where it didn't reach. Finally know *where* your trace failed, not just *that* it failed.
-
----
-
-## 📊 Things That Were Lying To You
-
-- "By Repeaters" was counting companions. Fixed.
-- Zero-hop adverts claimed "1 byte hash" when the hash size was unknowable. Fixed.
-- "Packets through this node" showed packets through a *different* node with the same prefix. Fixed — now uses the neighbor affinity graph.
-- Table sorting on nodes/neighbors/observers silently did nothing. Fixed.
-
----
-
-## 🔗 Deep Links · 🎨 Channel Colors · 📱 Mobile · 🔑 Security
-
-**Deep links** — every page state goes in the URL. Share a link to a specific node, filter, or analytics tab.
-
-**Channel colors** — click the color dot next to any channel, pick from 8 colors, see it highlighted across the feed. Persists in localStorage.
-
-**Distance units** — km, miles, or auto-detect from locale. Customizer → Display.
-
-**Mobile** — 44px touch targets, ARIA labels, responsive breakpoints.
-
-**Security** — weak API keys rejected at startup. License: GPL v3.
-
----
-
-## 📡 Full API Documentation
-
-Every endpoint is now documented with an auto-generated OpenAPI 3.0 spec — always in sync with the running server.
-
-- **Interactive Swagger UI:** [analyzer.00id.net/api/docs](https://analyzer.00id.net/api/docs) — browse and test all 40+ endpoints
-- **Machine-readable spec:** [analyzer.00id.net/api/spec](https://analyzer.00id.net/api/spec) — import into Postman, Insomnia, or use for bot/integration development
-
-On your own instance: `/api/docs` and `/api/spec`.
-
----
-
-## 🐛 14 Bugs Squashed
-
-Live map crash, zero-hop hash lies, animation freezes, repeater miscounts, prefix collisions, dead channel picker, invisible buttons, broken sorting, memory leak, and more.
-
----
-
-## Upgrade
-
-```bash
-docker stop <container-name> && docker rm <container-name>
-docker pull ghcr.io/kpa-clawbot/corescope:v3.5.0
-
-# HTTP only:
-docker run -d --name corescope -p 80:80 -p 1883:1883 \
-  -v /your/data:/app/data \
-  ghcr.io/kpa-clawbot/corescope:v3.5.0
-
-# With HTTPS (custom domain):
-docker run -d --name corescope -p 80:80 -p 443:443 -p 1883:1883 \
-  -v /your/data:/app/data \
-  -v /your/Caddyfile:/etc/caddy/Caddyfile:ro \
-  -v /your/caddy-data:/data/caddy \
-  ghcr.io/kpa-clawbot/corescope:v3.5.0
-```
-
-First start backfills `resolved_path` in the background. No downtime. No breaking changes.

docs/specs/rf-health-dashboard.md

@@ -431,10 +431,6 @@ Note: No hardcoded duty cycle limit line on charts. Duty cycle regulations vary
 - All charts time-aligned, sharing X-axis, reboot markers spanning all charts
 - Tests: delta computation, reboot handling, counter reset, gap insertion, downsampling, error rate calculation
 
-#### M2 feedback improvements (post-M2)
-- **Auto-scale airtime Y-axis**: clamp to min/max of actual data values (20% headroom, min 1%) instead of fixed 0-100%, matching noise floor chart behavior. Increases data-ink ratio for low-activity nodes.
-- **Hover tooltips on all chart data points**: invisible SVG circles with `<title>` elements on every data point across all 4 charts (noise floor, airtime, error rate, battery). Shows exact value + UTC timestamp on hover. Detail-on-demand without cluttering the chart.
-
 ### M3: Pattern detection
 - Implement after operators have used raw charts (M1–M2) and provided feedback
 - Jammer detection (NF spike + RX drop)

docs/specs/table-sorting.md

@@ -1,144 +0,0 @@
-# Table Sorting Consistency Spec (#620)
-
-## Problem
-
-CoreScope has 20+ data tables. Only 2 are sortable (nodes list, channel activity). Those 2 use incompatible implementations — different property names (`column`/`direction` vs `col`/`dir`), different data attributes (`data-sort` vs `data-sort-col`), different function signatures. The remaining 18+ tables, including the packets table (30K+ rows), have zero sorting.
-
-This violates AGENTS.md DRY rules and frustrates users who can see data but can't reorder it.
-
-## Solution
-
-One shared `TableSort` module. Every data table uses it. Same UX everywhere.
-
-## Shared Utility Design
-
-### Module: `public/table-sort.js`
-
-IIFE pattern (like `channel-colors.js`). No dependencies. No build step.
-
-```js
-window.TableSort = (function() {
-  return { init, sort, destroy };
-})();
-```
-
-### API
-
-```js
-TableSort.init(tableEl, {
-  defaultColumn: 'last_seen',     // initial sort column
-  defaultDirection: 'desc',       // 'asc' or 'desc'
-  storageKey: 'nodes-sort',       // localStorage key (optional)
-  comparators: {                  // custom comparators for non-string columns
-    time: (a, b) => ...,
-    snr:  (a, b) => ...,
-  },
-  onSort: (column, direction) => {} // callback after sort completes
-});
-```
-
-### How It Works
-
-1. Scans `<th>` elements for `data-sort="columnName"` attribute
-2. Attaches click handlers — click toggles asc/desc
-3. On sort: reads `<td data-value="...">` (raw sortable value) from each row
-4. Sorts rows in-place via DOM reorder (no innerHTML rebuild — important for 30K rows)
-5. Updates visual indicator and `aria-sort` on active `<th>`
-
-### Visual Indicator
-
-Active column header gets `▲` (ascending) or `▼` (descending) appended as a `<span class="sort-arrow">`. Inactive columns show no arrow. CSS class `.sort-active` on the active `<th>`.
-
-### Built-in Comparators
-
-| Type | Detected From | Behavior |
-|------|--------------|----------|
-| `numeric` | `data-type="number"` on `<th>` | `Number(a) - Number(b)`, NaN sorts last |
-| `text` | default | `localeCompare` |
-| `date` | `data-type="date"` | Parse as timestamp, numeric compare |
-| `dbm` | `data-type="dbm"` | Strip " dBm" suffix, numeric compare |
-
-Custom comparators in `options.comparators` override built-in types.
-
-### Accessibility
-
-- `aria-sort="ascending"`, `"descending"`, or `"none"` on every sortable `<th>`
-- `role="columnheader"` (already implicit for `<th>`)
-- `cursor: pointer` and `:hover` style on sortable headers
-- Keyboard: sortable headers are focusable, Enter/Space triggers sort
-
-### Performance (Critical for Packets Table)
-
-- Sort via DOM node reorder (`appendChild` loop), not `innerHTML`. Browser batches reflows.
-- `data-value` attributes hold raw values — no parsing during sort.
-- For 30K rows: expected sort time ~100-200ms (single `Array.sort` + DOM reorder). If >500ms, add a virtual scroll layer in a follow-up — but don't pre-optimize.
-- No re-render of row content. Sort only changes order.
-
-## Milestones
-
-### M1: Shared utility + packets table
-- Create `public/table-sort.js`
-- Unit tests: `test-table-sort.js` (Node.js, jsdom or vm.createContext)
-- Integrate with packets table (highest impact — 30K rows, currently unsortable)
-- Default sort: time descending
-- Columns: all current packets columns (Region, Time, Hash, Size, HB, Type, Observer, Path, Rpt, Details)
-- Browser validation: sort 30K rows, verify <500ms
-
-### M2: Nodes list + node detail tables
-- Migrate nodes list from custom sort to `TableSort.init()`
-- Add sorting to neighbor table (side pane + detail page)
-- Add sorting to observer stats table (detail page)
-- Remove old `sortState`/`sortArrow` code from `nodes.js`
-
-### M3: Analytics tables
-- Hash collisions tables (node table, sizes table, collision prefixes)
-- RF statistics table
-- Route frequency, co-appearance, topology tables
-- Node health tables (top by packets/SNR/observers, recently active)
-- Distance tables (by link type, top 20 longest)
-- Per-node analytics: peer contacts
-
-### M4: Channels list + observers list + comparison table
-- Channel activity table: migrate from custom sort to `TableSort.init()`
-- Remove old `_channelSortState` code from `analytics.js`
-- Observers list table
-- Comparison table (`compare.js`)
-
-### M5: Cleanup
-- Remove all old sorting code (both implementations)
-- Verify no dead CSS/JS from old sort code
-- Final consistency audit: every data table uses `TableSort.init()`
-
-### Out of Scope
-- `packets.js` hex breakdown (structural decode, fixed order)
-- `audio-lab.js` debug tables (not user-facing)
-- Virtual scroll / pagination (separate issue if perf requires it)
-
-## Testing
-
-### Unit Tests (`test-table-sort.js`)
-- Numeric sort ascending/descending
-- Text sort with localeCompare
-- Date sort
-- dBm sort (strip suffix)
-- Custom comparator override
-- NaN/null/undefined sort to end
-- Toggle direction on repeated click
-- `aria-sort` attribute updates
-- localStorage persistence (read + write)
-- `data-value` attribute used over text content
-
-### Integration (per milestone)
-- Playwright test: click column header, verify row order changes
-- Playwright test: click again, verify direction toggles
-- Playwright test: visual indicator present on active column
-
-### Performance
-- Unit test: sort 30K mock rows in <500ms (assert timing)
-- Required per AGENTS.md: perf claims need proof
-
-## Migration Path
-
-Existing sort code in `nodes.js` and `analytics.js` will be replaced, not wrapped. Both current implementations are <100 lines each — replacing is simpler than adapting. The shared utility subsumes all their functionality.
-
-Old localStorage keys (`nodes-sort-*`, channel sort state) should be migrated or cleared on first use of the new utility.

docs/specs/timestamp-filters.md

@@ -1,266 +0,0 @@
-# Timestamp-Based Packet Filters
-
-**Issue:** #289  
-**Status:** Draft  
-**Depends on:** #286 (timestamp display config)
-
-## Summary
-
-Extend the existing filter engine (`packet-filter.js`) with a `time` field type supporting absolute ISO timestamps, relative durations, and range expressions. The filter compiles date expressions to epoch milliseconds at parse time so per-packet evaluation is a single numeric comparison — no date parsing in the hot path.
-
-## Syntax
-
-### Absolute (ISO 8601)
-
-```
-time > "2024-01-01T00:00:00Z"
-time <= "2024-06-15"
-time == "2024-03-01"
-```
-
-Quoted strings after `time` are parsed as dates. Partial dates (`"2024-01-01"`) are treated as midnight UTC. All absolute values are interpreted as UTC regardless of the user's display preference.
-
-### Relative
-
-```
-time > 2h ago
-time > 30m ago
-time > 7d ago
-```
-
-The lexer recognizes `<number><unit> ago` as a relative time literal. Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days). At compile time, the relative offset is resolved to an absolute epoch ms value (`Date.now() - offset`). This means a compiled filter's relative thresholds are frozen at compile time — recompile to refresh.
-
-### Shorthand
-
-```
-time.ago < 30m
-time.ago < 2h
-```
-
-`time.ago` resolves to `Date.now() - packet.timestamp`. The comparison value is a duration literal (`30m`, `2h`, `7d`). This is syntactic sugar and semantically equivalent to the relative form but reads more naturally for "show me recent packets."
-
-### Range
-
-```
-time between "2024-01-01" "2024-01-02"
-time between 1h ago 30m ago
-```
-
-`between` is a ternary operator: `field between <low> <high>`. Compiles to `low <= field && field <= high`. Both bounds are inclusive.
-
-### Combinable with existing filters
-
-```
-type == Advert && time > 1h ago
-snr > 5 && time between "2024-01-01" "2024-01-02"
-(type == GRP_TXT || type == TXT_MSG) && time.ago < 30m
-```
-
-## Grammar Extension
-
-### New token types
-
-| Token | Pattern | Example |
-|-------|---------|---------|
-| `DURATION` | `/^\d+[smhd]$/` | `30m`, `2h`, `7d` |
-| `AGO` | keyword `ago` | `ago` |
-| `BETWEEN` | keyword `between` | `between` |
-
-### Lexer changes
-
-1. After reading an identifier that matches `\d+[smhd]`, emit `DURATION` token instead of `FIELD`.
-2. Recognize `ago` and `between` as keywords (like `and`/`or`).
-
-### Parser changes
-
-In `parseComparison()`:
-
-1. **Relative time:** If field is `time` and value tokens are `DURATION AGO`, compute `Date.now() - durationToMs(duration)` and store as a numeric epoch ms value in the AST node.
-2. **Absolute time:** If field is `time` and value is a `STRING`, attempt `new Date(value).getTime()`. If `NaN`, return parse error. Store epoch ms.
-3. **`time.ago` shorthand:** If field is `time.ago`, the value is a `DURATION`. Store the duration in ms. At evaluation, compute `now - packet_ts` and compare against the duration.
-4. **`between`:** If operator token is `BETWEEN`, consume two values (same type resolution as above). Emit `{ type: 'between', field, low, high }`.
-
-### AST node shapes
-
-```js
-// Absolute/relative (pre-resolved to epoch ms)
-{ type: 'comparison', field: 'time', op: '>', value: 1704067200000 }
-
-// time.ago (duration in ms)
-{ type: 'comparison', field: 'time.ago', op: '<', value: 1800000 }
-
-// between (both bounds as epoch ms)
-{ type: 'between', field: 'time', low: 1704067200000, high: 1704153600000 }
-```
-
-## Field Resolution
-
-Add to `resolveField()`:
-
-```js
-if (field === 'time') return packet.timestamp;  // epoch ms
-if (field === 'time.ago') return Date.now() - packet.timestamp;
-```
-
-`packet.timestamp` is the packet's capture time in epoch milliseconds. This field already exists in the data model (populated from the DB `created_at` column).
-
-## Time Semantics
-
-- **Filter expressions:** Always UTC. `"2024-01-01"` means `2024-01-01T00:00:00Z`.
-- **Display:** Follows the user's timestamp config from #286 (UTC/local/relative).
-- **Relative times:** Computed against `Date.now()` at compile time. The compiled filter is a snapshot — if the filter stays active for hours, relative thresholds drift. This is acceptable; filters are typically short-lived or recompiled on interaction.
-
-**No timezone specifiers in the filter syntax.** UTC only. This avoids ambiguity and parsing complexity. Users who think in local time can use the relative syntax (`time > 2h ago`) which is timezone-agnostic.
-
-## Performance
-
-### Compile-time work (once)
-
-- Parse date strings → epoch ms via `new Date().getTime()` (~1μs per date)
-- Parse duration strings → ms via multiplication (~0ns, trivial arithmetic)
-- Relative `ago` → `Date.now() - offset` (~0ns)
-
-### Per-packet evaluation (hot path)
-
-- `time` comparison: one numeric read + one numeric compare. Same cost as `snr > 5`.
-- `time.ago`: one subtraction + one compare. Two arithmetic ops. **Important:** cache `Date.now()` once per filter pass (e.g., in a closure variable set before iterating packets), not per-packet. 30K `Date.now()` calls are ~1ms but it's a pointless syscall tax.
-- `between`: two numeric compares.
-
-**No `Date` objects created per packet. No string parsing per packet. No regex per packet.**
-
-At 30K packets, the time filter adds ~0.1ms total to filter evaluation — dominated by the existing field resolution and AST walk overhead. No measurable regression.
-
-### Implementation note: `between` as sugar
-
-`between` should compile to `{ type: 'and', left: { type: 'comparison', field, op: '>=', value: low }, right: { type: 'comparison', field, op: '<=', value: high } }` — reusing existing comparison evaluation. No new AST node type, no new evaluator branch. The parser desugars it; the evaluator never sees `between`.
-
-### Implementation note: `time.ago` and `Date.now()` caching
-
-The `compile()` function should return a filter that accepts an optional `now` parameter:
-
-```js
-var compiled = compile('time.ago < 30m');
-var now = Date.now();
-packets.filter(function(p) { return compiled.filter(p, now); });
-```
-
-If `now` is not passed, `Date.now()` is called once on the first invocation and reused for the entire filter pass. This avoids 30K syscalls and ensures consistent evaluation within a single pass.
-
-## Carmack Review Notes
-
-Reviewed with a performance-first lens (30K+ packets, real-time updates):
-
-1. **✅ No allocations in hot path.** All date parsing happens at compile time. Per-packet evaluation is pure numeric comparison — same cost as existing `snr > 5` filters.
-
-2. **⚠️ `Date.now()` per-packet for `time.ago`.** Fixed above — cache once per filter pass via optional `now` parameter or closure. Without this, 30K packets × `Date.now()` = ~1ms wasted on a monotonic clock syscall that returns the same value.
-
-3. **✅ `between` as sugar, not a new node type.** Desugar in the parser to reuse existing `and` + `comparison` nodes. Zero new code paths in the evaluator = zero new bugs in the evaluator.
-
-4. **✅ Parser complexity is bounded.** Three new token types, one new keyword. The parser remains LL(1) — no backtracking, no ambiguity. `DURATION AGO` is a clear two-token lookahead only when field is `time`.
-
-5. **✅ Memory impact negligible.** Compiled time filters add one or two floats to the AST. At 16 bytes per node, even complex expressions with multiple time clauses are <100 bytes.
-
-6. **⚠️ Compiled filter staleness for relative times.** Spec acknowledges this. Acceptable for a web UI where filters are recompiled on user interaction. If filters persist across long WebSocket sessions, consider recompiling on a timer (every 60s). This is a future concern, not a blocker.
-
-7. **✅ No regex in hot path.** Duration parsing uses a simple char check on the last character + `parseInt`. Cheaper than any regex.
-
-A compiled time filter adds one or two 64-bit float values to the AST. Negligible — roughly 16 bytes per time comparison node.
-
-## URL Integration
-
-Time filters appear in the URL hash query string like any other filter:
-
-```
-#/packets?filter=time%20%3E%201h%20ago
-#/packets?filter=type%20%3D%3D%20Advert%20%26%26%20time%20%3E%20%222024-01-01%22
-```
-
-The filter text is URL-encoded and round-trips through `encodeURIComponent`/`decodeURIComponent`. No special handling needed — the existing filter-in-URL mechanism (#286 or current) works unchanged.
-
-For convenience, a future milestone could add dedicated `timeFrom`/`timeTo` query params that inject into the filter, but this is not required for the initial implementation.
-
-## Wireshark Compatibility
-
-| Wireshark syntax | CoreScope equivalent | Notes |
-|------------------|---------------------|-------|
-| `frame.time >= "2024-01-01"` | `time >= "2024-01-01"` | We use `time` instead of `frame.time` for brevity. Could alias `frame.time` → `time` later. |
-| `frame.time_relative < 60` | `time.ago < 60s` | Wireshark uses seconds float; we use duration literals |
-| `frame.time_delta` | Not supported | Inter-packet delta is a different feature |
-
-We intentionally diverge from Wireshark where their syntax is verbose or requires pcap-specific concepts. CoreScope's filter language prioritizes brevity and readability for a web UI. A `frame.time` alias for `time` can be added trivially in the field resolver if users request it.
-
-## Milestones
-
-### M1: Core time filtering (parser + evaluator)
-- Add `DURATION`, `AGO`, `BETWEEN` tokens to lexer
-- Extend parser for `time` field special handling
-- Add `time` and `time.ago` to `resolveField()`
-- Implement `between` AST node evaluation
-- Unit tests: absolute, relative, ago, between, combined with existing filters, edge cases (bad dates, invalid units)
-- **Test:** filter 30K packets by time in <50ms (assert in test)
-
-### M2: UI integration
-- Filter bar autocomplete hints for time syntax
-- Help tooltip / cheat sheet update with time examples
-- Verify URL round-trip with time filters
-- Playwright E2E test: enter time filter, verify packet list updates
-
-### M3: Polish
-- `frame.time` alias
-- Error messages for common mistakes ("did you mean `time > 1h ago`?")
-- Consider dedicated time range picker UI widget (out of scope for this spec)
-
-## Testing
-
-### Unit tests (add to `test-packet-filter.js`)
-
-```js
-// Absolute time
-c = compile('time > "2024-01-01"');
-assert(c.filter({ timestamp: new Date('2024-06-01').getTime() }), 'after 2024-01-01');
-assert(!c.filter({ timestamp: new Date('2023-06-01').getTime() }), 'before 2024-01-01');
-
-// Relative time
-c = compile('time > 1h ago');
-assert(c.filter({ timestamp: Date.now() - 30 * 60000 }), '30m ago passes 1h filter');
-assert(!c.filter({ timestamp: Date.now() - 2 * 3600000 }), '2h ago fails 1h filter');
-
-// time.ago shorthand
-c = compile('time.ago < 30m');
-assert(c.filter({ timestamp: Date.now() - 10 * 60000 }), '10m ago < 30m');
-assert(!c.filter({ timestamp: Date.now() - 60 * 60000 }), '60m ago not < 30m');
-
-// between
-c = compile('time between "2024-01-01" "2024-01-02"');
-assert(c.filter({ timestamp: new Date('2024-01-01T12:00:00Z').getTime() }), 'in range');
-assert(!c.filter({ timestamp: new Date('2024-01-03').getTime() }), 'out of range');
-
-// Combined
-c = compile('type == Advert && time > 1h ago');
-assert(c.filter({ payload_type: 4, timestamp: Date.now() - 1000 }), 'combined pass');
-assert(!c.filter({ payload_type: 4, timestamp: Date.now() - 7200000 }), 'combined fail time');
-assert(!c.filter({ payload_type: 1, timestamp: Date.now() - 1000 }), 'combined fail type');
-
-// Error cases
-c = compile('time > "not-a-date"');
-assert(c.error, 'invalid date string');
-
-c = compile('time > 5x ago');
-assert(c.error, 'invalid duration unit');
-
-// Performance
-var start = Date.now();
-c = compile('time > 1h ago && type == Advert');
-var packets = [];
-for (var i = 0; i < 30000; i++) {
-  packets.push({ payload_type: i % 5, timestamp: Date.now() - i * 1000 });
-}
-packets.forEach(function(p) { c.filter(p); });
-assert(Date.now() - start < 50, 'filter 30K packets in <50ms');
-```
-
-### Playwright tests
-
-- Enter `time > 1h ago` in filter bar → verify packet count decreases
-- Enter invalid time filter → verify error message appears
-- Reload page with time filter in URL → verify filter is applied

docs/superpowers/plans/2026-04-05-deep-linking-p1.md

@@ -1,674 +0,0 @@
-# Deep Linking P1 Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Make P1 UI states in nodes, packets, and channels URL-addressable so they survive refresh and can be shared.
-
-**Architecture:** Each page reads URL params from `location.hash.split('?')[1]` on init (router strips query string before passing `routeParam`, so pages must read `location.hash` directly). State changes call `history.replaceState` to keep the URL in sync. localStorage remains the fallback default; URL params override when present.
-
-**Tech Stack:** Vanilla JS (ES5/6), browser History API, URLSearchParams
-
----
-
-## Files Changed
-
-| File | Changes |
-|---|---|
-| `public/region-filter.js` | Add `setSelected(codesArray)`, track `_container` for re-render |
-| `public/nodes.js` | Read `?tab=`/`?search=` on init; `updateNodesUrl()` on tab/search change; expose `buildNodesQuery` on `window` |
-| `public/packets.js` | Read `?timeWindow=`/`?region=` on init; `updatePacketsUrl()` on timeWindow/region change; expose `buildPacketsUrl` on `window` |
-| `public/channels.js` | Read `?node=` on init; update URL in `showNodeDetail`/`closeNodeDetail` |
-| `test-frontend-helpers.js` | Add unit tests for `buildNodesQuery` and `buildPacketsUrl` |
-| `test-e2e-playwright.js` | Add Playwright tests: tab URL persistence, timeWindow URL persistence |
-
----
-
-## Task 1: Add `setSelected` to RegionFilter
-
-**Files:**
-- Modify: `public/region-filter.js`
-
-- [ ] **Step 1: Write the failing unit test**
-
-Add to `test-frontend-helpers.js` before the `// ===== SUMMARY =====` line:
-
-```javascript
-// ===== REGION-FILTER.JS: setSelected =====
-console.log('\n=== region-filter.js: setSelected ===');
-{
-  const ctx = makeSandbox();
-  ctx.fetch = () => Promise.resolve({ json: () => Promise.resolve({ 'US-SFO': 'San Jose', 'US-LAX': 'Los Angeles' }) });
-  loadInCtx(ctx, 'public/region-filter.js');
-
-  const RF = ctx.RegionFilter;
-  RF.init(document.createElement('div'));
-
-  test('setSelected sets region codes', async () => {
-    await RF.init(document.createElement('div'));
-    RF.setSelected(['US-SFO', 'US-LAX']);
-    assert.strictEqual(RF.getRegionParam(), 'US-SFO,US-LAX');
-  });
-
-  test('setSelected with null clears selection', async () => {
-    await RF.init(document.createElement('div'));
-    RF.setSelected(['US-SFO']);
-    RF.setSelected(null);
-    assert.strictEqual(RF.getRegionParam(), '');
-  });
-
-  test('setSelected with empty array clears selection', async () => {
-    await RF.init(document.createElement('div'));
-    RF.setSelected(['US-SFO']);
-    RF.setSelected([]);
-    assert.strictEqual(RF.getRegionParam(), '');
-  });
-}
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -A2 "setSelected"
-```
-
-Expected: `❌ setSelected sets region codes: RF.setSelected is not a function`
-
-- [ ] **Step 3: Add `_container` tracking and `setSelected` to region-filter.js**
-
-In `region-filter.js`, add `var _container = null;` after the existing module-level vars (after line 9 `var _listeners = [];`):
-
-```javascript
-  var _listeners = [];
-  var _container = null;   // ← add this line
-  var _loaded = false;
-```
-
-In `initFilter`, save the container:
-
-```javascript
-  async function initFilter(container, opts) {
-    _container = container;          // ← add this line
-    if (opts && opts.dropdown) container._forceDropdown = true;
-    await fetchRegions();
-    render(container);
-  }
-```
-
-Add `setSelected` function before `// Expose globally`:
-
-```javascript
-  /** Override selected regions (e.g. from URL param). Persists to localStorage and re-renders. */
-  function setSelected(codesArray) {
-    _selected = (codesArray && codesArray.length > 0) ? new Set(codesArray) : null;
-    saveToStorage();
-    if (_container) render(_container);
-  }
-```
-
-Add `setSelected` to the public API object:
-
-```javascript
-  window.RegionFilter = {
-    init: initFilter,
-    render: render,
-    getSelected: getSelected,
-    getRegionParam: getRegionParam,
-    regionQueryString: regionQueryString,
-    onChange: onChange,
-    offChange: offChange,
-    fetchRegions: fetchRegions,
-    setSelected: setSelected,    // ← add this line
-  };
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -E "(setSelected|FAIL|passed|failed)"
-```
-
-Expected: 3 passing `setSelected` tests, overall pass.
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add public/region-filter.js test-frontend-helpers.js
-git commit -m "feat: add RegionFilter.setSelected for URL param initialization (#536)"
-```
-
----
-
-## Task 2: nodes.js — tab and search deep linking
-
-**Files:**
-- Modify: `public/nodes.js`
-- Test: `test-frontend-helpers.js`
-- Test: `test-e2e-playwright.js`
-
-- [ ] **Step 1: Write the unit test (add to test-frontend-helpers.js)**
-
-Add before the `// ===== SUMMARY =====` line:
-
-```javascript
-// ===== NODES.JS: buildNodesQuery =====
-console.log('\n=== nodes.js: buildNodesQuery ===');
-{
-  const ctx = makeSandbox();
-  loadInCtx(ctx, 'public/roles.js');
-  loadInCtx(ctx, 'public/app.js');
-
-  // Provide required globals for nodes.js IIFE to execute
-  ctx.registerPage = () => {};
-  ctx.RegionFilter = { init: () => Promise.resolve(), onChange: () => () => {}, offChange: () => {}, getSelected: () => null, getRegionParam: () => '' };
-  ctx.onWS = () => {};
-  ctx.offWS = () => {};
-  ctx.debouncedOnWS = () => () => {};
-  ctx.invalidateApiCache = () => {};
-  ctx.favStar = () => '';
-  ctx.bindFavStars = () => {};
-  ctx.getFavorites = () => [];
-  ctx.isFavorite = () => false;
-  ctx.connectWS = () => {};
-  ctx.HopResolver = { init: () => {}, resolve: () => ({}), ready: () => false };
-  ctx.initTabBar = () => {};
-  ctx.debounce = (fn) => fn;
-  ctx.copyToClipboard = () => {};
-  ctx.api = () => Promise.resolve({});
-  ctx.escapeHtml = (s) => s;
-  ctx.timeAgo = () => '';
-  ctx.formatTimestampWithTooltip = () => '';
-  ctx.getTimestampMode = () => 'ago';
-  ctx.CLIENT_TTL = {};
-  ctx.qrcode = null;
-
-  try {
-    const src = fs.readFileSync('public/nodes.js', 'utf8');
-    vm.runInContext(src, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-  } catch (e) {
-    console.log('  ⚠️ nodes.js sandbox load failed:', e.message.slice(0, 120));
-  }
-
-  const buildNodesQuery = ctx.buildNodesQuery;
-
-  if (buildNodesQuery) {
-    test('buildNodesQuery: all tab + no search = empty', () => {
-      assert.strictEqual(buildNodesQuery('all', ''), '');
-    });
-    test('buildNodesQuery: repeater tab only', () => {
-      assert.strictEqual(buildNodesQuery('repeater', ''), '?tab=repeater');
-    });
-    test('buildNodesQuery: search only (all tab)', () => {
-      assert.strictEqual(buildNodesQuery('all', 'foo'), '?search=foo');
-    });
-    test('buildNodesQuery: tab + search combined', () => {
-      assert.strictEqual(buildNodesQuery('companion', 'bar'), '?tab=companion&search=bar');
-    });
-    test('buildNodesQuery: null search treated as empty', () => {
-      assert.strictEqual(buildNodesQuery('all', null), '');
-    });
-    test('buildNodesQuery: sensor tab', () => {
-      assert.strictEqual(buildNodesQuery('sensor', ''), '?tab=sensor');
-    });
-  } else {
-    console.log('  ⚠️ buildNodesQuery not exposed — skipping');
-  }
-}
-```
-
-- [ ] **Step 2: Run test to verify it fails (or skips)**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -A3 "buildNodesQuery"
-```
-
-Expected: `⚠️ buildNodesQuery not exposed — skipping`
-
-- [ ] **Step 3: Add URL param reading and helpers to nodes.js**
-
-**3a.** Add `buildNodesQuery` and `updateNodesUrl` functions inside the nodes.js IIFE, after the `TABS` definition (around line 86, before `function renderNodeTimestampHtml`):
-
-```javascript
-  function buildNodesQuery(tab, searchStr) {
-    var parts = [];
-    if (tab && tab !== 'all') parts.push('tab=' + encodeURIComponent(tab));
-    if (searchStr) parts.push('search=' + encodeURIComponent(searchStr));
-    return parts.length ? '?' + parts.join('&') : '';
-  }
-  window.buildNodesQuery = buildNodesQuery;
-
-  function updateNodesUrl() {
-    history.replaceState(null, '', '#/nodes' + buildNodesQuery(activeTab, search));
-  }
-```
-
-**3b.** In the list-view branch of `init` (after the `return;` that ends the full-screen block at line 317), add URL param reading before `app.innerHTML`:
-
-```javascript
-    // Read URL params for list view (router strips query string from routeParam)
-    const _listUrlParams = new URLSearchParams(location.hash.split('?')[1] || '');
-    const _urlTab = _listUrlParams.get('tab');
-    const _urlSearch = _listUrlParams.get('search');
-    if (_urlTab && TABS.some(function(t) { return t.key === _urlTab; })) activeTab = _urlTab;
-    if (_urlSearch) search = _urlSearch;
-
-    app.innerHTML = `<div class="nodes-page">
-```
-
-**3c.** After `app.innerHTML = ...` (after the closing backtick at line ~330), populate the search input:
-
-```javascript
-    if (search) {
-      var _si = document.getElementById('nodeSearch');
-      if (_si) _si.value = search;
-    }
-```
-
-**3d.** In the search input event listener (around line 335), add `updateNodesUrl()`:
-
-```javascript
-    document.getElementById('nodeSearch').addEventListener('input', debounce(e => {
-      search = e.target.value;
-      updateNodesUrl();
-      loadNodes();
-    }, 250));
-```
-
-**3e.** In the tab click handler inside `renderLeft` (around line 875), add `updateNodesUrl()`:
-
-```javascript
-      btn.addEventListener('click', () => { activeTab = btn.dataset.tab; updateNodesUrl(); loadNodes(); });
-```
-
-- [ ] **Step 4: Run unit tests**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -E "(buildNodesQuery|✅|❌)" | grep -v "helpers"
-```
-
-Expected: 6 passing `buildNodesQuery` tests.
-
-- [ ] **Step 5: Write Playwright test (add to test-e2e-playwright.js)**
-
-Add before the closing `await browser.close()` line:
-
-```javascript
-  // --- Group: Deep linking (#536) ---
-
-  // Test: nodes tab deep link
-  await test('Nodes tab deep link restores active tab', async () => {
-    await page.goto(BASE + '#/nodes?tab=repeater', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.node-tab', { timeout: 8000 });
-    const activeTab = await page.$('.node-tab.active');
-    assert(activeTab, 'No active tab found');
-    const tabText = await activeTab.textContent();
-    assert(tabText.includes('Repeater'), `Expected Repeater tab active, got: ${tabText}`);
-    const url = page.url();
-    assert(url.includes('tab=repeater'), `URL should contain tab=repeater, got: ${url}`);
-  });
-
-  // Test: nodes tab click updates URL
-  await test('Nodes tab click updates URL', async () => {
-    await page.goto(BASE + '#/nodes', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.node-tab', { timeout: 8000 });
-    const roomTab = await page.$('.node-tab[data-tab="room"]');
-    if (roomTab) {
-      await roomTab.click();
-      await page.waitForTimeout(300);
-      const url = page.url();
-      assert(url.includes('tab=room'), `URL should contain tab=room after click, got: ${url}`);
-    }
-  });
-```
-
-- [ ] **Step 6: Run full test suite**
-
-```bash
-node test-frontend-helpers.js
-```
-
-Expected: all tests pass.
-
-- [ ] **Step 7: Commit**
-
-```bash
-git add public/nodes.js test-frontend-helpers.js test-e2e-playwright.js
-git commit -m "feat: deep link nodes tab and search query (#536)"
-```
-
----
-
-## Task 3: packets.js — timeWindow and region deep linking
-
-**Files:**
-- Modify: `public/packets.js`
-- Test: `test-frontend-helpers.js`
-- Test: `test-e2e-playwright.js`
-
-> Depends on Task 1 (RegionFilter.setSelected).
-
-- [ ] **Step 1: Write the unit test**
-
-Add to `test-frontend-helpers.js` before `// ===== SUMMARY =====`:
-
-```javascript
-// ===== PACKETS.JS: buildPacketsUrl =====
-console.log('\n=== packets.js: buildPacketsUrl ===');
-{
-  // Test the pure helper function
-  // (loaded via packets.js after it exposes window.buildPacketsUrl)
-  const ctx = makeSandbox();
-  loadInCtx(ctx, 'public/roles.js');
-  loadInCtx(ctx, 'public/app.js');
-
-  ctx.registerPage = () => {};
-  ctx.RegionFilter = { init: () => Promise.resolve(), onChange: () => () => {}, offChange: () => {}, getSelected: () => null, getRegionParam: () => '', setSelected: () => {} };
-  ctx.onWS = () => {};
-  ctx.offWS = () => {};
-  ctx.debouncedOnWS = () => () => {};
-  ctx.invalidateApiCache = () => {};
-  ctx.api = () => Promise.resolve({});
-  ctx.observerMap = new Map();
-  ctx.getParsedPath = () => [];
-  ctx.getParsedDecoded = () => ({});
-  ctx.clearParsedCache = () => {};
-  ctx.escapeHtml = (s) => s;
-  ctx.timeAgo = () => '';
-  ctx.formatTimestampWithTooltip = () => '';
-  ctx.getTimestampMode = () => 'ago';
-  ctx.copyToClipboard = () => {};
-  ctx.CLIENT_TTL = {};
-  ctx.debounce = (fn) => fn;
-  ctx.initTabBar = () => {};
-
-  try {
-    const src = fs.readFileSync('public/packet-helpers.js', 'utf8');
-    vm.runInContext(src, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-    const src2 = fs.readFileSync('public/packets.js', 'utf8');
-    vm.runInContext(src2, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-  } catch (e) {
-    console.log('  ⚠️ packets.js sandbox load failed:', e.message.slice(0, 120));
-  }
-
-  const buildPacketsUrl = ctx.buildPacketsUrl;
-
-  if (buildPacketsUrl) {
-    test('buildPacketsUrl: default (15min, no region) = bare #/packets', () => {
-      assert.strictEqual(buildPacketsUrl(15, ''), '#/packets');
-    });
-    test('buildPacketsUrl: non-default timeWindow', () => {
-      assert.strictEqual(buildPacketsUrl(60, ''), '#/packets?timeWindow=60');
-    });
-    test('buildPacketsUrl: region only', () => {
-      assert.strictEqual(buildPacketsUrl(15, 'US-SFO'), '#/packets?region=US-SFO');
-    });
-    test('buildPacketsUrl: timeWindow + region', () => {
-      assert.strictEqual(buildPacketsUrl(30, 'US-SFO,US-LAX'), '#/packets?timeWindow=30&region=US-SFO%2CUS-LAX');
-    });
-    test('buildPacketsUrl: timeWindow=0 treated as default', () => {
-      assert.strictEqual(buildPacketsUrl(0, ''), '#/packets');
-    });
-  } else {
-    console.log('  ⚠️ buildPacketsUrl not exposed — skipping');
-  }
-}
-```
-
-- [ ] **Step 2: Run to verify it skips**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -A2 "buildPacketsUrl"
-```
-
-Expected: `⚠️ buildPacketsUrl not exposed — skipping`
-
-- [ ] **Step 3: Add helpers and URL param reading to packets.js**
-
-**3a.** Add `buildPacketsUrl` and `updatePacketsUrl` inside the packets.js IIFE, after the existing constants at the top (around line 36, after `let showHexHashes`):
-
-```javascript
-  function buildPacketsUrl(timeWindowMin, regionParam) {
-    var parts = [];
-    if (timeWindowMin && timeWindowMin !== 15) parts.push('timeWindow=' + timeWindowMin);
-    if (regionParam) parts.push('region=' + encodeURIComponent(regionParam));
-    return '#/packets' + (parts.length ? '?' + parts.join('&') : '');
-  }
-  window.buildPacketsUrl = buildPacketsUrl;
-
-  function updatePacketsUrl() {
-    history.replaceState(null, '', buildPacketsUrl(savedTimeWindowMin, RegionFilter.getRegionParam()));
-  }
-```
-
-**3b.** In the `init` function (around line 263), add URL param reading after the existing `routeParam`/`directObsId` parsing and before `app.innerHTML`:
-
-```javascript
-    // Read URL params for filter state (router strips query from routeParam; read from location.hash)
-    var _initUrlParams = new URLSearchParams(location.hash.split('?')[1] || '');
-    var _urlTimeWindow = Number(_initUrlParams.get('timeWindow'));
-    if (Number.isFinite(_urlTimeWindow) && _urlTimeWindow > 0) {
-      savedTimeWindowMin = _urlTimeWindow;
-      localStorage.setItem('meshcore-time-window', String(_urlTimeWindow));
-    }
-    var _urlRegion = _initUrlParams.get('region');
-    if (_urlRegion) {
-      RegionFilter.setSelected(_urlRegion.split(',').filter(Boolean));
-    }
-
-    app.innerHTML = `<div class="split-layout detail-collapsed">
-```
-
-**3c.** In the time window change handler (around line 865), add `updatePacketsUrl()`:
-
-```javascript
-    fTimeWindow.addEventListener('change', () => {
-      savedTimeWindowMin = Number(fTimeWindow.value);
-      if (!Number.isFinite(savedTimeWindowMin) || savedTimeWindowMin <= 0) savedTimeWindowMin = 15;
-      localStorage.setItem('meshcore-time-window', fTimeWindow.value);
-      updatePacketsUrl();
-      loadPackets();
-    });
-```
-
-**3d.** In the RegionFilter.onChange callback (around line 719), add `updatePacketsUrl()`:
-
-```javascript
-    RegionFilter.onChange(function() { updatePacketsUrl(); loadPackets(); });
-```
-
-- [ ] **Step 4: Run unit tests**
-
-```bash
-node test-frontend-helpers.js 2>&1 | grep -E "(buildPacketsUrl|✅|❌)" | grep -v "helpers"
-```
-
-Expected: 5 passing `buildPacketsUrl` tests.
-
-- [ ] **Step 5: Write Playwright test (add to test-e2e-playwright.js, inside the deep-linking group)**
-
-```javascript
-  // Test: packets timeWindow deep link
-  await test('Packets timeWindow deep link restores dropdown', async () => {
-    await page.goto(BASE + '#/packets?timeWindow=60', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('#fTimeWindow', { timeout: 8000 });
-    const val = await page.$eval('#fTimeWindow', el => el.value);
-    assert(val === '60', `Expected timeWindow dropdown = 60, got: ${val}`);
-    const url = page.url();
-    assert(url.includes('timeWindow=60'), `URL should still contain timeWindow=60, got: ${url}`);
-  });
-
-  // Test: timeWindow change updates URL
-  await test('Packets timeWindow change updates URL', async () => {
-    await page.goto(BASE + '#/packets', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('#fTimeWindow', { timeout: 8000 });
-    await page.selectOption('#fTimeWindow', '30');
-    await page.waitForTimeout(300);
-    const url = page.url();
-    assert(url.includes('timeWindow=30'), `URL should contain timeWindow=30 after change, got: ${url}`);
-  });
-```
-
-- [ ] **Step 6: Run full test suite**
-
-```bash
-node test-frontend-helpers.js
-```
-
-Expected: all tests pass.
-
-- [ ] **Step 7: Commit**
-
-```bash
-git add public/packets.js test-frontend-helpers.js test-e2e-playwright.js
-git commit -m "feat: deep link packets timeWindow and region filter (#536)"
-```
-
----
-
-## Task 4: channels.js — node panel deep linking
-
-**Files:**
-- Modify: `public/channels.js`
-
-No unit tests needed for this task — the URL manipulation is side-effectful (DOM + History API). Playwright tests cover it.
-
-- [ ] **Step 1: Write the Playwright test (add to test-e2e-playwright.js, inside the deep-linking group)**
-
-```javascript
-  // Test: channels selected channel survives refresh (already implemented, verify it still works)
-  await test('Channels channel selection is URL-addressable', async () => {
-    await page.goto(BASE + '#/channels', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.ch-item', { timeout: 8000 }).catch(() => null);
-    const firstChannel = await page.$('.ch-item');
-    if (firstChannel) {
-      await firstChannel.click();
-      await page.waitForTimeout(500);
-      const url = page.url();
-      assert(url.includes('#/channels/') || url.includes('#/channels'), `URL should reflect channel selection, got: ${url}`);
-    }
-  });
-```
-
-- [ ] **Step 2: Update `showNodeDetail` to write `?node=` to the URL**
-
-In `channels.js`, in `showNodeDetail` (around line 171), add the URL update right after `selectedNode = name;`:
-
-```javascript
-  async function showNodeDetail(name) {
-    _nodePanelTrigger = document.activeElement;
-    if (_focusTrapCleanup) { _focusTrapCleanup(); _focusTrapCleanup = null; }
-    const node = await lookupNode(name);
-    selectedNode = name;
-    var _chBase = selectedHash ? '#/channels/' + encodeURIComponent(selectedHash) : '#/channels';
-    history.replaceState(null, '', _chBase + '?node=' + encodeURIComponent(name));
-
-    let panel = document.getElementById('chNodePanel');
-```
-
-- [ ] **Step 3: Update `closeNodeDetail` to strip `?node=` from the URL**
-
-In `closeNodeDetail` (around line 232), add URL restore right after `selectedNode = null;`:
-
-```javascript
-  function closeNodeDetail() {
-    if (_focusTrapCleanup) { _focusTrapCleanup(); _focusTrapCleanup = null; }
-    const panel = document.getElementById('chNodePanel');
-    if (panel) panel.classList.remove('open');
-    selectedNode = null;
-    var _chRestoreUrl = selectedHash ? '#/channels/' + encodeURIComponent(selectedHash) : '#/channels';
-    history.replaceState(null, '', _chRestoreUrl);
-    if (_nodePanelTrigger && typeof _nodePanelTrigger.focus === 'function') {
-```
-
-- [ ] **Step 4: Read `?node=` on init and auto-open panel**
-
-In `channels.js` `init` (line 316), add URL param reading at the very top of the function (before `app.innerHTML`):
-
-```javascript
-  function init(app, routeParam) {
-    var _initUrlParams = new URLSearchParams(location.hash.split('?')[1] || '');
-    var _pendingNode = _initUrlParams.get('node');
-
-    app.innerHTML = `<div class="ch-layout">
-```
-
-Then update the `loadChannels().then(...)` call (around line 350) to auto-open the node panel:
-
-```javascript
-    loadChannels().then(async function () {
-      if (routeParam) await selectChannel(routeParam);
-      if (_pendingNode) showNodeDetail(_pendingNode);
-    });
-```
-
-- [ ] **Step 5: Run full test suite**
-
-```bash
-node test-frontend-helpers.js
-```
-
-Expected: all tests pass (no channels unit tests, but regression tests still pass).
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add public/channels.js
-git commit -m "feat: deep link channels node panel via ?node= (#536)"
-```
-
----
-
-## Task 5: Run E2E Playwright tests
-
-- [ ] **Step 1: Start the local server**
-
-```bash
-cd cmd/server && go run . &
-```
-
-Wait for it to be ready (check `http://localhost:3000`).
-
-- [ ] **Step 2: Run Playwright tests**
-
-```bash
-node test-e2e-playwright.js
-```
-
-Expected: all tests pass including the new deep-linking group.
-
-- [ ] **Step 3: If any deep-linking test fails, debug**
-
-Common failures:
-- Selector `.node-tab.active` not found: check that nodes.js correctly reads `?tab=` from URL before rendering
-- `#fTimeWindow` value wrong: check that `savedTimeWindowMin` is overridden before the DOM is built
-- URL doesn't update: check `history.replaceState` calls in the change handlers
-
-- [ ] **Step 4: Final commit (if any fixes needed)**
-
-```bash
-git add public/nodes.js public/packets.js public/channels.js
-git commit -m "fix: deep linking E2E adjustments (#536)"
-```
-
----
-
-## Self-Review
-
-**Spec coverage check:**
-- ✅ P1: Nodes role tab → Task 2
-- ✅ P1: Packets time window → Task 3
-- ✅ P1: Packets region filter → Task 3 (depends on Task 1)
-- ✅ P1: Channels selected channel → Already implemented via `#/channels/{hash}` (verified in channels.js init line 351)
-- ✅ P1: Channels node panel → Task 4
-- ✅ P2+ items → explicitly out of scope per issue
-
-**Architecture note:** The router in `app.js` strips the query string at line 422 (`const route = hash.split('?')[0]`) before computing `basePage` and `routeParam`. Therefore `#/nodes?tab=repeater` gives `routeParam=null` (not `?tab=repeater`). All pages must read URL params from `location.hash` directly, not from `routeParam`. This is the established pattern in `analytics.js` and `nodes.js` (section scroll).
-
-**Placeholder scan:** No TBDs, no "implement later", all code blocks complete. ✅
-
-**Type consistency:**
-- `buildNodesQuery(tab, searchStr)` — used consistently in `updateNodesUrl()` and in tests ✅
-- `buildPacketsUrl(timeWindowMin, regionParam)` — used consistently in `updatePacketsUrl()` and in tests ✅
-- `RegionFilter.setSelected(codesArray)` — defined in Task 1, used in Task 3 ✅

docs/test-plans/v3.4.2-manual-validation.md

@@ -1,162 +0,0 @@
-# v3.4.2 Manual Validation Checklist
-
-**Tester:** _______________
-**Staging:** http://20.109.157.39
-**Prod:** https://analyzer.00id.net (READ ONLY — do not deploy until staging passes)
-**Browser:** Chrome + Firefox + Safari (mobile for responsive items)
-**Time estimate:** ~45 minutes
-
----
-
-## 🔴 HIGH RISK — Test First
-
-### 1. Zero-hop hash size display (#649, #653)
-- [ ] Go to Packets page, find a DIRECT advert (route_type=2, 0 hops)
-- [ ] Open packet detail — hash size should say "Unknown (zero-hop)" or be hidden, NOT "1 byte"
-- [ ] Check "Path Length" field shows `hash_count=0 (direct advert)` 
-- [ ] Find a FLOOD advert with 0 hops — it SHOULD show hash size (this is different from DIRECT)
-
-### 2. TRACE packet real path (#651, #656)
-- [ ] Send a trace from your companion
-- [ ] Watch Live map — the animated dot should only travel along completed hops (solid line)
-- [ ] Unreached hops should show as dashed/ghosted line at reduced opacity
-- [ ] If trace completes fully, entire path should be solid
-- [ ] Ghost line should auto-clean after ~10 seconds
-
-### 3. "Paths through this node" accuracy (#655, #658)
-- [ ] Go to: http://20.109.157.39/#/nodes/c0dedad4208acb6cbe44b848943fc6d3c5d43cf38a21e48b43826a70862980e4
-- [ ] Check "Packets through this node" — packets should actually have this node in their path
-- [ ] Compare with a node that shares a 2-char prefix (e.g. C0ffee SF) — they should show DIFFERENT packets
-- [ ] Spot-check 3-4 packets: click through, verify path contains the node
-
-### 4. Hash Stats "By Repeaters" (#652, #654)
-- [ ] Go to Analytics → Hash Stats
-- [ ] "By Repeaters" section should only show repeater-role nodes
-- [ ] Compare count in "Multi-Byte Hash Adopters" vs "By Repeaters" — adopters may include companions, repeaters section should not
-- [ ] Check that companions/rooms/sensors are excluded from the repeater distribution
-
-### 5. Noise floor column chart (#600, #659)
-- [ ] Go to Analytics → RF Health
-- [ ] Noise floor chart should show vertical color-coded bars, NOT a line
-- [ ] Green bars (< -100 dBm), yellow (-100 to -85), red (≥ -85)
-- [ ] Hover over a bar — tooltip should show exact dBm + timestamp
-- [ ] Check with only 1 observer selected — chart should still render (division by zero edge case)
-- [ ] Reboot markers (if any) should show as vertical dashed lines
-
-### 6. Async backfill on startup
-- [ ] SSH to staging: `ssh -i ~/.ssh/id_ed25519 runner@20.109.157.39`
-- [ ] `docker restart corescope-staging-go`
-- [ ] Within 30 seconds, hit `curl http://localhost:82/api/stats` — should return data (not hang)
-- [ ] Check `backfilling` and `backfillProgress` fields in stats response
-- [ ] Server should be serving HTTP while backfill runs in background
-
----
-
-## 🟡 MEDIUM RISK — Features
-
-### 7. Distance unit preference (#621, #646)
-- [ ] Go to Customizer → Display tab
-- [ ] Change distance unit to "mi" — all distances should show in miles
-- [ ] Change to "km" — all distances should show in km
-- [ ] Change to "auto" — should use locale (US = miles, EU = km)
-- [ ] Check Analytics page distances update after customizer change (no page reload needed)
-- [ ] Check Node detail → Neighbors table distances
-- [ ] Very small distances (<0.1 mi) should show in feet, not "0.0 mi"
-
-### 8. Panel corner toggle (#608, #657)
-- [ ] Go to Live map page
-- [ ] Each panel (feed, legend, node detail) should have a small corner-toggle button
-- [ ] Click the button — panel should snap to next corner (TL → TR → BR → BL)
-- [ ] Refresh page — panel positions should persist (localStorage)
-- [ ] Move two panels to same corner — collision avoidance should skip to next free corner
-- [ ] On mobile viewport (<768px?) — toggle buttons should be hidden
-
-### 9. Deep linking (#536, #618)
-- [ ] Navigate to Nodes page, click a node → URL should update with pubkey hash
-- [ ] Copy URL, open in new tab → should land on same node
-- [ ] Apply packet filters → URL hash should include filter params
-- [ ] Channels page: select a node → URL should reflect selection
-- [ ] Analytics tabs: switch tabs → URL should include tab name
-- [ ] Share a deep link with someone — they should see the same view
-
-### 10. Sortable tables (#620, #638, #639)
-- [ ] Nodes list: click column headers — should sort ascending/descending
-- [ ] Sort indicator (arrow) should be visible on active column
-- [ ] Node detail → Neighbors table: sortable
-- [ ] Node detail → Observers table: sortable
-- [ ] Packets table: sortable by column headers
-
-### 11. Channel color highlighting (#271, #607, #611)
-- [ ] Go to Channels page
-- [ ] Assign a color to a channel using the color picker
-- [ ] Feed rows should highlight with that color
-- [ ] Change color — should update immediately
-- [ ] Refresh — color assignment should persist
-
-### 12. Collapsible panels (#606)
-- [ ] Live map: panels should have collapse/expand toggle
-- [ ] Collapsed panel should show just the header
-- [ ] State should persist across page navigations
-
-### 13. Mobile accessibility (#630, #633)
-- [ ] Open staging on phone (or Chrome DevTools mobile emulation)
-- [ ] Touch targets should be at least 44×44px
-- [ ] Channel color picker should work on mobile
-- [ ] No horizontal scroll on any page
-- [ ] ARIA labels present on interactive elements (inspect with accessibility tools)
-
-### 14. Map byte-size filter (#565, #568)
-- [ ] Go to Map page
-- [ ] Find the byte-size filter control
-- [ ] Filter by packet size — map should update to show only matching packets
-- [ ] Clear filter — all packets should return
-
-### 15. API key security (#532, #628)
-- [ ] Try accessing a write endpoint without API key — should be blocked
-- [ ] Try with a weak key (e.g., "test", "admin") — should be rejected at startup
-- [ ] Check staging logs for API key warning: `docker logs corescope-staging-go 2>&1 | grep -i "apiKey\|api_key\|security"`
-
-### 16. OpenAPI/Swagger (#530, #632)
-- [ ] Hit http://20.109.157.39/api/spec — should return valid OpenAPI 3.0 spec
-- [ ] Hit http://20.109.157.39/api/docs — should show Swagger UI
-- [ ] Try an endpoint from Swagger UI — should work
-
----
-
-## 🟢 LOW RISK — Verify Quickly
-
-### 17. View Route on Map button
-- [ ] Go to any packet detail page
-- [ ] Click "View Route on Map" — should navigate to map with route highlighted
-
-### 18. og-image compression
-- [ ] Check page source or network tab — og-image.png should be < 300KB (was 1.1MB)
-
-### 19. Prefix Tool
-- [ ] Analytics → Prefix Tool tab should load
-- [ ] Should show collision data
-
-### 20. License
-- [ ] Check repo footer/LICENSE — should be GPL v3
-
-### 21. Docker DISABLE_CADDY
-- [ ] (If testable) Set DISABLE_CADDY=true — Caddy should not start
-
-### 22. Region filter on RF Health
-- [ ] RF Health tab: change region filter — charts should update
-
----
-
-## 🏁 Sign-off
-
-| Section | Status | Notes |
-|---------|--------|-------|
-| High risk (1-6) | ☐ | |
-| Medium risk (7-16) | ☐ | |
-| Low risk (17-22) | ☐ | |
-| **Overall** | ☐ | |
-
-**Tested by:** _______________  
-**Date:** _______________  
-**Staging version:** `curl -s http://20.109.157.39/api/stats | jq .version`  
-**Ready for release:** ☐ Yes / ☐ No — blockers: _______________

docs/test-plans/v3.4.2-release-test-plan.md

@@ -1,309 +0,0 @@
-# v3.4.2 Release Test Plan
-
-**Scope:** 90 commits since v3.4.1 (84 files, +14,931 / -1,005)  
-**Categories:** 19 perf, 19 feat, 18 fix, 15 docs, 3 chore, 1 test, 1 refactor, 1 ci  
-**Date:** 2026-04-08
-
----
-
-## A. Automated Tests — Verify All Pass
-
-### Go Backend
-```bash
-cd cmd/server && go test -race -count=1 ./...
-cd cmd/ingestor && go test -race -count=1 ./...
-```
-
-**Test files (27 total):**
-
-| File | Tests For |
-|------|-----------|
-| `cmd/server/decoder_test.go` | Hash size zero-hop, TRACE hopsCompleted, transport direct |
-| `cmd/server/backfill_async_test.go` | **NEW** — Async chunked backfill |
-| `cmd/server/eviction_test.go` | Memory eviction with runtime heap stats |
-| `cmd/server/apikey_security_test.go` | **NEW** — Weak/default API key rejection |
-| `cmd/server/openapi_test.go` | **NEW** — OpenAPI spec generation |
-| `cmd/server/routes_test.go` | Batch observations endpoint, subpaths-bulk, expand=observations |
-| `cmd/server/cache_invalidation_test.go` | cacheTTL config wiring |
-| `cmd/server/config_knobs_test.go` | cacheTTLSec helper |
-| `cmd/server/helpers_test.go` | constantTimeEqual, IsWeakAPIKey |
-| `cmd/server/obs_dedup_test.go` | UniqueObserverCount tracking |
-| `cmd/server/neighbor_*.go` (4 files) | Neighbor graph, affinity, persistence |
-| `cmd/server/perfstats_race_test.go` | Perf stats concurrency |
-| `cmd/server/resolve_context_test.go` | Resolved path filtering |
-| `cmd/server/advert_pubkey_test.go` | Advert pubkey tracking |
-| `cmd/server/db_test.go` | SQLite operations |
-| `cmd/server/config_test.go` | Config loading |
-| `cmd/server/coverage_test.go` | Coverage helpers |
-| `cmd/server/parity_test.go` | Go/JS decoder parity |
-| `cmd/server/websocket_test.go` | WebSocket broadcast |
-| `cmd/ingestor/decoder_test.go` | Ingestor decoder (hash size zero-hop) |
-| `cmd/ingestor/db_test.go` | Ingestor DB writes |
-| `cmd/ingestor/config_test.go` | Ingestor config |
-| `cmd/ingestor/main_test.go` | Ingestor entry |
-| `cmd/ingestor/coverage_boost_test.go` | Coverage helpers |
-
-### Frontend Unit Tests
-```bash
-node test-packet-filter.js
-node test-aging.js
-node test-frontend-helpers.js
-node test-table-sort.js          # NEW — shared table sort utility
-node test-channel-colors.js      # NEW — channel color model
-node test-panel-corner.js        # NEW — panel corner toggle
-node test-packets.js             # NEW — packets page logic
-node test-hop-resolver-affinity.js
-node test-customizer-v2.js
-node test-live.js
-node test-live-dedup.js
-```
-
-### E2E / Playwright
-```bash
-BASE_URL=http://localhost:13581 node test-e2e-playwright.js
-```
-
-**Expected:** All existing tests pass + new tests added for sortable tables, deep linking, collapsible panels.
-
----
-
-## B. Manual Browser Verification
-
-### B1. HIGH RISK — Data Correctness
-
-| # | Feature | Page | What to Check |
-|---|---------|------|---------------|
-| 1 | Hash size zero-hop | Packets detail | Find a direct (route_type=0) packet → hash_size should show 0, not a bogus computed value |
-| 2 | TRACE hopsCompleted | Packets detail / Live map | Find a TRACE packet → verify `hopsCompleted` shows in decoded JSON, live map shows real path length vs intended |
-| 3 | Transport direct hash size | Packets detail | Find route_type=RouteTransportDirect packet → hash_size=0 |
-| 4 | resolved_path filtering | Node detail → Paths tab | Verify path-hop candidates use resolved_path, no prefix collision false positives |
-| 5 | Hash stats repeater filter | Analytics → Hash Issues | "By Repeaters" should only show nodes with repeater role, not companions/sensors |
-| 6 | Async chunked backfill | Server startup | Start server with large DB → verify HTTP serves within 2 minutes, `X-CoreScope-Status: backfilling` header present, then transitions to `ready` |
-| 7 | Memory eviction (heap stats) | Admin/stats | Verify `/api/stats` shows realistic memory numbers from runtime heap, not the old estimation |
-| 8 | Distance/subpath/path-hop indexes | Analytics → Distances, Subpaths | Verify analytics data matches v3.4.1 output (no missing or extra entries) |
-| 9 | cacheTTL config wiring | Config | Set `cacheTTL.analyticsHashSizes: 300` in config → verify collision cache respects it |
-
-### B2. MEDIUM RISK — User-Facing Features
-
-| # | Feature | Page | What to Check |
-|---|---------|------|---------------|
-| 10 | Distance unit preference | Nodes detail, Map | Toggle km/mi/auto in settings → distances update throughout UI |
-| 11 | Panel corner toggle | Live page | Click corner toggle → panel moves to opposite corner, persists on reload |
-| 12 | Noise floor column chart | Analytics → RF | Verify column chart renders with color-coded thresholds, hover shows values |
-| 13 | Deep linking UI states | All pages | Navigate to `#/nodes?tab=neighbors`, `#/packets?observer=X`, `#/channels?node=Y` → correct state loads. Copy URL, open in new tab → same state |
-| 14 | Sortable tables | Nodes list, Neighbors, Observers | Click column headers → sort asc/desc, indicator arrow shows, persists correctly |
-| 15 | Channel color highlighting | Channels, Live feed | Assign color to channel → feed rows show that color, persists on reload |
-| 16 | Mobile accessibility | All pages (phone viewport) | Touch targets ≥44px, ARIA labels present, small viewport doesn't overflow |
-| 17 | Collapsible panels | Live map | Collapse/expand panels, medium breakpoint auto-collapses, state persists |
-| 18 | Byte-size map filter | Map page | Filter by byte size → markers update correctly |
-| 19 | OpenAPI/Swagger | `/api/spec`, `/api/docs` | Spec loads valid JSON, Swagger UI renders and all endpoints are documented |
-| 20 | API key rejection | Protected endpoints | Send weak key (e.g. "changeme", "test123") → 403 forbidden |
-| 21 | Channel color picker mobile | Channels (phone viewport) | Color picker usable on touch, doesn't overflow |
-| 22 | RF Health dashboard | Analytics → RF Health | Observer metrics grid, airtime charts, battery charts, error rate, region filter |
-| 23 | Prefix Tool tab | Analytics → Prefix Tool | Renders correctly, collision data consistent with Hash Issues |
-| 24 | View Route on Map | Packet detail page | Button works and shows route on map |
-
-### B3. LOWER RISK — Performance (Verify No Regressions)
-
-| # | Feature | Page | What to Check |
-|---|---------|------|---------------|
-| 25 | Incremental DOM diff | Packets (30K+) | Virtual scroll renders smoothly, no visible flicker |
-| 26 | Coalesced WS renders | Live page | Rapid packets don't cause frame drops (rAF coalescing) |
-| 27 | Marker reposition on zoom | Map | Zoom/resize → markers move smoothly, no full rebuild flash |
-| 28 | Parallel replay fetches | Live → VCR | Replay loads quickly (parallel observation fetches) |
-| 29 | Batch observations API | Packets page (sort change) | Changing sort fetches observations in batch (network tab: 1 POST not N GETs) |
-| 30 | Client-side network status | Analytics | No separate API call for network status |
-| 31 | og-image compression | `/og-image.png` | Verify loads, ~235KB not ~1.1MB |
-
----
-
-## C. API Regression Tests
-
-Run against a local server with test-fixture DB:
-
-```bash
-BASE=http://localhost:13581
-
-# Core endpoints — verify response shape
-curl -s "$BASE/api/stats" | jq '.totalPackets, .backfilling, .backfillProgress'
-curl -s "$BASE/api/packets?limit=5" | jq '.packets[0] | keys'
-curl -s "$BASE/api/packets?limit=5&expand=observations" | jq '.packets[0].observations | length'
-curl -s "$BASE/api/nodes?limit=5" | jq '.[0] | keys'
-
-# New endpoints
-curl -s -X POST "$BASE/api/packets/observations" \
-  -H 'Content-Type: application/json' \
-  -d '{"hashes":["test123"]}' | jq '.results | keys'
-
-curl -s "$BASE/api/analytics/subpaths-bulk?hops=A,B&hops=B,C" | jq 'keys'
-
-curl -s "$BASE/api/observers/metrics/summary" | jq 'type'
-curl -s "$BASE/api/spec" | jq '.openapi'
-curl -s "$BASE/api/docs" | head -5  # Should return HTML
-
-# Backfill status header
-curl -sI "$BASE/api/stats" | grep X-CoreScope-Status
-
-# API key rejection
-curl -s -H 'X-API-Key: changeme' "$BASE/api/debug/vars" | jq '.error'
-curl -s -H 'X-API-Key: test' "$BASE/api/debug/vars" | jq '.error'
-
-# Existing endpoints — verify not broken
-curl -s "$BASE/api/analytics/rf?timeRange=24h" | jq 'keys'
-curl -s "$BASE/api/analytics/hash-sizes" | jq 'type'
-curl -s "$BASE/api/analytics/distances" | jq 'type'
-curl -s "$BASE/api/analytics/subpaths" | jq 'type'
-curl -s "$BASE/api/channels" | jq 'type'
-curl -s "$BASE/api/config/client" | jq 'keys'
-```
-
-### Expected response shape changes from v3.4.1:
-- `/api/stats` now includes `backfilling` (bool) and `backfillProgress` (float 0-1)
-- `/api/packets` no longer strips observations by default (lazy via `ExpandObservations` flag) — verify `observations` key absent without `expand=observations`
-- Decoded packets with route_type=direct now have `hashSize: 0`
-- TRACE packets now have `path.hopsCompleted` field
-
----
-
-## D. Performance Regression Tests
-
-### D1. Server Startup Time
-```bash
-# Start server with production-size DB (~30K packets)
-# Measure time from process start to first successful HTTP response
-time curl -s http://localhost:13581/api/stats > /dev/null
-# Target: < 2 minutes (async backfill requirement)
-```
-
-### D2. Go Benchmarks
-```bash
-cd cmd/server && go test -bench=. -benchmem -count=3
-```
-Key benchmarks to compare with v3.4.1 baseline:
-- `BenchmarkQueryPackets` — should not regress with new indexes
-- `BenchmarkEvictStale` — batch removal from secondary indexes
-- `BenchmarkGetStoreStats` — 2 concurrent queries vs 5 sequential
-- `BenchmarkIngestNew` — additional index maintenance overhead
-
-### D3. Frontend Performance
-- Open Packets page with 30K+ packets → measure initial render time (DevTools Performance tab)
-- Scroll rapidly through virtual scroll → should maintain 60fps
-- Switch sort column on packets → single batch POST, not N+1 GETs
-- Open Analytics page → no redundant API calls in network tab
-
-### D4. Memory Usage
-- After loading 30K packets, check `/api/stats` memory figure
-- Compare with v3.4.1 baseline (prefix map cap at 8 chars should reduce ~10x)
-- Verify eviction triggers at correct memory threshold using runtime heap stats
-
----
-
-## E. Infrastructure / Deployment Tests
-
-### E1. Docker Build
-```bash
-docker build -t corescope:test .
-docker run --rm -p 13581:13581 corescope:test
-# Verify: container starts, HTTP responds, WebSocket connects
-```
-
-### E2. GHCR Publish (CI)
-- Verify CI publishes to `ghcr.io/kpa-clawbot/corescope`
-- Verify tags: `edge` (master), `vX.Y.Z` (release)
-
-### E3. Staging Deploy
-```bash
-# Verify staging compose works with standard ports
-docker compose -f docker-compose.staging.yml up -d
-# Check: no 3GB memory limit, standard port binding
-```
-
-### E4. DISABLE_CADDY
-```bash
-docker run --rm -e DISABLE_CADDY=true corescope:test
-# Verify: Caddy not started, Go server serves directly
-```
-
-### E5. CI Pipeline
-- Verify consolidated pipeline: build → publish GHCR → deploy staging
-- Verify runs on `meshcore-runner-2`
-
----
-
-## F. Edge Cases & Integration Tests
-
-### F1. Cross-Feature Interactions
-| Scenario | Risk |
-|----------|------|
-| Deep link to sorted table → sort state matches URL params | Medium |
-| Channel color + deep link → color persists in linked URL | Medium |
-| Panel corner toggle + collapsible panels → both states persist independently | Low |
-| Distance unit pref + neighbor table sort by distance → sort uses correct unit | Medium |
-| Noise floor chart + region filter → chart respects filter | Medium |
-| Byte-size map filter + channel color highlighting → both active simultaneously | Low |
-
-### F2. Data Correctness Edge Cases
-| Scenario | Risk |
-|----------|------|
-| Zero-hop TRACE packet (should NOT reset hashSize — TRACE exemption) | **High** |
-| Packet with all hops having same 2-char prefix → resolved_path filtering prevents false match | **High** |
-| Node that switches role (repeater → companion) → hash stats updates | Medium |
-| Backfill interrupted mid-chunk (server restart) → resumes or completes on next start | Medium |
-| Empty DB startup → no errors, backfill completes instantly | Low |
-| DB with 100K+ packets → async backfill doesn't OOM, progress reported | **High** |
-
-### F3. Concurrency / Race Conditions
-| Scenario | Risk |
-|----------|------|
-| Concurrent API requests during backfill → no deadlock (lock ordering documented) | **High** |
-| Eviction running while analytics query in progress → no stale pointer panic | **High** |
-| Multiple WebSocket clients during high ingest rate → coalesced broadcasts don't drop | Medium |
-| `time.NewTicker` cleanup on graceful shutdown (replaced `time.Tick`) | Low |
-
-### F4. API Key Security
-| Scenario | Expected |
-|----------|----------|
-| No API key configured → write endpoints disabled | 403 "write endpoints disabled" |
-| Weak key "changeme" → rejected even if configured | 403 "forbidden" |
-| Timing-safe comparison → no timing oracle | Constant-time via `crypto/subtle` |
-| Empty string key → rejected | 401 "unauthorized" |
-
-### F5. Browser Compatibility
-- Test on Chrome, Firefox, Safari (latest)
-- Test on iOS Safari, Android Chrome
-- Verify touch targets on mobile (44px minimum)
-- Verify ARIA labels with screen reader
-
----
-
-## G. Test Coverage Gaps — Action Items
-
-| Gap | Priority | Action |
-|-----|----------|--------|
-| No automated test for distance unit preference rendering | Medium | Add Playwright test |
-| No automated test for noise floor column chart | Medium | Add Playwright test |
-| No automated test for deep link state restoration | **High** | Add Playwright tests for each deep-linkable state |
-| No automated test for channel color persistence | Medium | `test-channel-colors.js` covers model; need Playwright for UI |
-| No automated test for mobile viewport behavior | Medium | Add Playwright test with mobile viewport |
-| No automated test for backfill progress header | Low | Add to `routes_test.go` |
-| No automated test for `time.NewTicker` cleanup | Low | Add to graceful shutdown test |
-| Observer metrics endpoints not covered in route tests | Medium | Add to `routes_test.go` |
-| Subpaths-bulk endpoint needs test | Medium | Add to `routes_test.go` |
-| No load test for batch observations endpoint (200 hash limit) | Low | Add boundary test |
-
----
-
-## H. Release Checklist
-
-- [ ] All Go tests pass with `-race` flag
-- [ ] All frontend unit tests pass
-- [ ] Playwright E2E tests pass
-- [ ] Manual browser verification (Section B) complete
-- [ ] API regression tests (Section C) pass
-- [ ] Docker build succeeds
-- [ ] Staging deploy verified
-- [ ] No console errors on any page
-- [ ] Performance spot-checks (Section D) — no regressions
-- [ ] Coverage badges updated (backend ≥85%, frontend ≥42%)
-- [ ] CHANGELOG updated
-- [ ] Tag `v3.4.2` created

docs/user-guide/faq.md

@@ -52,14 +52,3 @@ CoreScope uses URL hashes for deep linking. Copy the URL from your browser — i
 - `#/packets/abc123` — a specific packet
 - `#/analytics?tab=collisions` — the hash issues tab
 - `#/nodes/pubkey123` — a specific node's detail page
-
-### Where is the API documentation?
-
-CoreScope auto-generates an OpenAPI 3.0 specification from its route definitions:
-
-- **Interactive docs (Swagger UI):** `/api/docs` — browse and test all 40+ endpoints from your browser
-- **Machine-readable spec:** `/api/spec` — import into Postman, Insomnia, or any OpenAPI tool
-
-The spec is always in sync with the running server. No manual maintenance needed.
-
-On the public instance: [analyzer.00id.net/api/docs](https://analyzer.00id.net/api/docs)

internal/sigvalidate/go.mod

@@ -1,3 +0,0 @@
-module github.com/meshcore-analyzer/sigvalidate
-
-go 1.22

internal/sigvalidate/sigvalidate.go

@@ -1,23 +0,0 @@
-// Package sigvalidate provides Ed25519 signature validation for MeshCore adverts.
-package sigvalidate
-
-import (
-	"crypto/ed25519"
-	"encoding/binary"
-)
-
-// ValidateAdvertSignature verifies an Ed25519 signature over a MeshCore advert.
-// The signed message is: pubKey (32 bytes) || timestamp (4 bytes LE) || appdata.
-// Returns false if pubKey is not 32 bytes or signature is not 64 bytes.
-func ValidateAdvertSignature(pubKey, signature []byte, timestamp uint32, appdata []byte) bool {
-	if len(pubKey) != 32 || len(signature) != 64 {
-		return false
-	}
-
-	message := make([]byte, 32+4+len(appdata))
-	copy(message[0:32], pubKey)
-	binary.LittleEndian.PutUint32(message[32:36], timestamp)
-	copy(message[36:], appdata)
-
-	return ed25519.Verify(ed25519.PublicKey(pubKey), message, signature)
-}

public/analytics.js

@@ -75,7 +75,7 @@
           <h2>📊 Mesh Analytics</h2>
           <p class="text-muted">Deep dive into your mesh network data</p>
           <div id="analyticsRegionFilter" class="region-filter-container"></div>
-          <div class="analytics-tabs" id="analyticsTabs" role="tablist" aria-label="Analytics tabs">
+          <div class="analytics-tabs" id="analyticsTabs">
             <button class="tab-btn active" data-tab="overview">Overview</button>
             <button class="tab-btn" data-tab="rf">RF / Signal</button>
             <button class="tab-btn" data-tab="topology">Topology</button>
@@ -90,7 +90,7 @@
             <button class="tab-btn" data-tab="prefix-tool">Prefix Tool</button>
           </div>
         </div>
-        <div id="analyticsContent" class="analytics-content" aria-live="polite">
+        <div id="analyticsContent" class="analytics-content">
           <div class="text-center text-muted" style="padding:40px">Loading analytics…</div>
         </div>
       </div>`;
@@ -136,14 +136,9 @@
       analyticsContent.addEventListener('keydown', handler);
     }
 
-    // Re-render when distance unit or theme changes
-    _themeRefreshHandler = function () { renderTab(_currentTab); };
-    window.addEventListener('theme-refresh', _themeRefreshHandler);
-
     loadAnalytics();
   }
 
-  var _themeRefreshHandler = null;
   let _currentTab = 'overview';
 
   async function loadAnalytics() {
@@ -997,7 +992,6 @@
         <span style="color:var(--border)">|</span>
         <a href="#/analytics?tab=prefix-tool" style="color:var(--accent)">🔎 Check a prefix →</a>
       </nav>
-      <p class="text-muted" style="margin:0 0 12px;font-size:0.78em">This tab shows operational collisions among <strong>repeaters</strong> grouped by their configured hash size. The <a href="#/analytics?tab=prefix-tool" style="color:var(--accent)">Prefix Tool</a> checks all repeaters regardless of their configured hash size.</p>
 
       <div class="analytics-card" id="inconsistentHashSection">
         <div style="display:flex;justify-content:space-between;align-items:center"><h3 style="margin:0">⚠️ Inconsistent Hash Sizes</h3><a href="#/analytics?tab=collisions" style="font-size:11px;color:var(--text-muted)">↑ top</a></div>
@@ -1203,45 +1197,6 @@
     </div>`;
   }
 
-  // --- Shared cell classification for hash matrix ---
-
-  function classifyHashCell(count, isConfirmedCollision, isPossibleConflict) {
-    if (count === 0) return { cls: 'hash-cell-empty', bg: '' };
-    if (!isConfirmedCollision && !isPossibleConflict) return { cls: 'hash-cell-taken', bg: '' };
-    if (isPossibleConflict) return { cls: 'hash-cell-possible', bg: '' };
-    const t = Math.min((count - 2) / 4, 1);
-    return { cls: 'hash-cell-collision', bg: `background:rgb(${Math.round(220+35*t)},${Math.round(120*(1-t))},30);` };
-  }
-
-  function hashCellTd(hex, cellSize, cls, bg, count, tipHtml, fontWeight) {
-    return `<td class="hash-cell ${cls}${count ? ' hash-active' : ''}" data-hex="${hex}" data-tip="${tipHtml.replace(/"/g,'&quot;')}" style="width:${cellSize}px;height:${cellSize}px;text-align:center;${bg}border:1px solid var(--border);cursor:${count ? 'pointer' : 'default'};font-size:11px;font-weight:${fontWeight}">${hex}</td>`;
-  }
-
-  function hashTooltipHtml(hexLabel, statusText, nodesHtml) {
-    let html = `<div class="hash-matrix-tooltip-hex">${hexLabel}</div><div class="hash-matrix-tooltip-status">${statusText}</div>`;
-    if (nodesHtml) html += `<div class="hash-matrix-tooltip-nodes">${nodesHtml}</div>`;
-    return html;
-  }
-
-  function renderHashMatrixPanel(el, statCardsHtml, cellRendererFn, detailMaxWidth, legendLabels, clickHandlerFn) {
-    const nibbles = '0123456789ABCDEF'.split('');
-    const cellSize = 36;
-    const headerSize = 24;
-    let html = statCardsHtml;
-    html += hashMatrixGridHtml(nibbles, cellSize, headerSize, cellRendererFn);
-    html += `<div id="hashDetail" style="flex:1;min-width:200px;max-width:${detailMaxWidth}px;font-size:0.85em"></div></div>`;
-    html += hashMatrixLegendHtml(legendLabels);
-    el.innerHTML = html;
-    initMatrixTooltip(el);
-    el.querySelectorAll('.hash-active').forEach(td => {
-      td.addEventListener('click', () => {
-        clickHandlerFn(td);
-        el.querySelectorAll('.hash-selected').forEach(c => c.classList.remove('hash-selected'));
-        td.classList.add('hash-selected');
-      });
-    });
-  }
-
   function renderHashMatrixFromServer(sizeData, bytes) {
     const el = document.getElementById('hashMatrix');
     if (!sizeData) { el.innerHTML = '<div class="text-muted">No data</div>'; return; }
@@ -1251,42 +1206,55 @@
     // 3-byte: show a summary panel instead of a matrix
     if (bytes === 3) {
       el.innerHTML = hashStatCardsHtml(totalNodes, stats.using_this_size || 0, '3-byte', 16777216, stats.unique_prefixes || 0, stats.collision_count || 0) +
-        `<p class="text-muted" style="margin:0;font-size:0.8em">The 3-byte prefix space (16.7M values) is too large to visualize as a grid.</p>` +
-        `<p class="text-muted" style="margin:8px 0 0;font-size:0.8em">ℹ️ This tab only counts collisions among repeaters configured for this hash size. The <a href="#/analytics?tab=prefix-tool" style="color:var(--accent)">Prefix Tool</a> checks all repeaters regardless of configured hash size.</p>`;
+        `<p class="text-muted" style="margin:0;font-size:0.8em">The 3-byte prefix space (16.7M values) is too large to visualize as a grid.</p>`;
       return;
     }
 
+    const nibbles = '0123456789ABCDEF'.split('');
+    const cellSize = 36;
+    const headerSize = 24;
+
     if (bytes === 1) {
       const oneByteCells = sizeData.one_byte_cells || {};
       const oneByteCount = stats.using_this_size || 0;
       const oneUsed = Object.values(oneByteCells).filter(v => v.length > 0).length;
       const oneCollisions = Object.values(oneByteCells).filter(v => v.length > 1).length;
 
-      renderHashMatrixPanel(el,
-        hashStatCardsHtml(totalNodes, oneByteCount, '1-byte', 256, oneUsed, oneCollisions),
-        (hex, cs) => {
+      let html = hashStatCardsHtml(totalNodes, oneByteCount, '1-byte', 256, oneUsed, oneCollisions);
+      html += hashMatrixGridHtml(nibbles, cellSize, headerSize, (hex, cs) => {
           const nodes = oneByteCells[hex] || [];
           const count = nodes.length;
           const repeaterCount = nodes.filter(n => n.role === 'repeater').length;
           const isCollision = count >= 2 && repeaterCount >= 2;
           const isPossible = count >= 2 && !isCollision;
-          const { cls, bg } = classifyHashCell(count, isCollision, isPossible);
+          let cellClass, bgStyle;
+          if (count === 0) { cellClass = 'hash-cell-empty'; bgStyle = ''; }
+          else if (count === 1) { cellClass = 'hash-cell-taken'; bgStyle = ''; }
+          else if (isPossible) { cellClass = 'hash-cell-possible'; bgStyle = ''; }
+          else { const t = Math.min((count - 2) / 4, 1); bgStyle = `background:rgb(${Math.round(220+35*t)},${Math.round(120*(1-t))},30);`; cellClass = 'hash-cell-collision'; }
           const nodeLabel = m => `<div style="font-size:11px">${esc(m.name||m.public_key.slice(0,12))}${!m.role ? ' <span style="opacity:0.7">(unknown role)</span>' : ''}</div>`;
-          const nodesPreview = nodes.slice(0,5).map(nodeLabel).join('') + (nodes.length > 5 ? `<div class="hash-matrix-tooltip-status">+${nodes.length-5} more</div>` : '');
-          const tip = count === 0 ? hashTooltipHtml(`0x${hex}`, 'Available')
-            : count === 1 ? hashTooltipHtml(`0x${hex}`, 'One node — no collision', nodeLabel(nodes[0]))
-            : isPossible ? hashTooltipHtml(`0x${hex}`, `${count} nodes — POSSIBLE CONFLICT`, nodesPreview)
-            : hashTooltipHtml(`0x${hex}`, `${count} nodes — COLLISION`, nodesPreview);
-          return hashCellTd(hex, cs, cls, bg, count, tip, count >= 2 ? '700' : '400');
-        },
-        400,
-        [
-          {cls: 'hash-cell-empty', style: 'border:1px solid var(--border)', text: 'Available'},
-          {cls: 'hash-cell-taken', text: 'One node'},
-          {cls: 'hash-cell-possible', text: 'Possible conflict'},
-          {cls: 'hash-cell-collision', style: 'background:rgb(220,80,30)', text: 'Collision'}
-        ],
-        (td) => {
+          const tip1 = count === 0
+            ? `<div class="hash-matrix-tooltip-hex">0x${hex}</div><div class="hash-matrix-tooltip-status">Available</div>`
+            : count === 1
+              ? `<div class="hash-matrix-tooltip-hex">0x${hex}</div><div class="hash-matrix-tooltip-status">One node — no collision</div><div class="hash-matrix-tooltip-nodes">${nodeLabel(nodes[0])}</div>`
+              : isPossible
+                ? `<div class="hash-matrix-tooltip-hex">0x${hex}</div><div class="hash-matrix-tooltip-status">${count} nodes — POSSIBLE CONFLICT</div><div class="hash-matrix-tooltip-nodes">${nodes.slice(0,5).map(nodeLabel).join('')}${nodes.length>5?`<div class="hash-matrix-tooltip-status">+${nodes.length-5} more</div>`:''}</div>`
+                : `<div class="hash-matrix-tooltip-hex">0x${hex}</div><div class="hash-matrix-tooltip-status">${count} nodes — COLLISION</div><div class="hash-matrix-tooltip-nodes">${nodes.slice(0,5).map(nodeLabel).join('')}${nodes.length>5?`<div class="hash-matrix-tooltip-status">+${nodes.length-5} more</div>`:''}</div>`;
+          return `<td class="hash-cell ${cellClass}${count ? ' hash-active' : ''}" data-hex="${hex}" data-tip="${tip1.replace(/"/g,'&quot;')}" style="width:${cs}px;height:${cs}px;text-align:center;${bgStyle}border:1px solid var(--border);cursor:${count ? 'pointer' : 'default'};font-size:11px;font-weight:${count >= 2 ? '700' : '400'}">${hex}</td>`;
+      });
+      html += `<div id="hashDetail" style="flex:1;min-width:200px;max-width:400px;font-size:0.85em"></div></div>`;
+      html += hashMatrixLegendHtml([
+        {cls: 'hash-cell-empty', style: 'border:1px solid var(--border)', text: 'Available'},
+        {cls: 'hash-cell-taken', text: 'One node'},
+        {cls: 'hash-cell-possible', text: 'Possible conflict'},
+        {cls: 'hash-cell-collision', style: 'background:rgb(220,80,30)', text: 'Collision'}
+      ]);
+      el.innerHTML = html;
+
+      initMatrixTooltip(el);
+
+      el.querySelectorAll('.hash-active').forEach(td => {
+        td.addEventListener('click', () => {
           const hex = td.dataset.hex.toUpperCase();
           const matches = oneByteCells[hex] || [];
           const detail = document.getElementById('hashDetail');
@@ -1297,8 +1265,10 @@
               const role = m.role ? `<span class="badge" style="font-size:0.7em;padding:1px 4px;background:var(--border)">${esc(m.role)}</span> ` : '';
               return `<div style="padding:3px 0">${role}<a href="#/nodes/${encodeURIComponent(m.public_key)}" class="analytics-link">${esc(m.name || m.public_key.slice(0,12))}</a> ${coords}</div>`;
             }).join('')}</div>`;
-        }
-      );
+          el.querySelectorAll('.hash-selected').forEach(c => c.classList.remove('hash-selected'));
+          td.classList.add('hash-selected');
+        });
+      });
 
     } else if (bytes === 2) {
       const twoByteCells = sizeData.two_byte_cells || {};
@@ -1306,34 +1276,38 @@
       const uniqueTwoBytePrefixes = stats.unique_prefixes || 0;
       const twoCollisions = Object.values(twoByteCells).filter(v => v.collision_count > 0).length;
 
-      renderHashMatrixPanel(el,
-        hashStatCardsHtml(totalNodes, twoByteCount, '2-byte', 65536, uniqueTwoBytePrefixes, twoCollisions),
-        (hex, cs) => {
+      let html = hashStatCardsHtml(totalNodes, twoByteCount, '2-byte', 65536, uniqueTwoBytePrefixes, twoCollisions);
+      html += hashMatrixGridHtml(nibbles, cellSize, headerSize, (hex, cs) => {
           const info = twoByteCells[hex] || { group_nodes: [], max_collision: 0, collision_count: 0, two_byte_map: {} };
           const nodeCount = (info.group_nodes || []).length;
           const maxCol = info.max_collision || 0;
           const overlapping = Object.values(info.two_byte_map || {}).filter(v => v.length > 1);
           const hasConfirmed = overlapping.some(ns => ns.filter(n => n.role === 'repeater').length >= 2);
           const hasPossible = !hasConfirmed && overlapping.some(ns => ns.length >= 2);
-          const { cls, bg } = classifyHashCell(maxCol > 0 ? maxCol : nodeCount === 0 ? 0 : 1, hasConfirmed, hasPossible);
+          let cellClass2, bgStyle2;
+          if (nodeCount === 0) { cellClass2 = 'hash-cell-empty'; bgStyle2 = ''; }
+          else if (maxCol === 0) { cellClass2 = 'hash-cell-taken'; bgStyle2 = ''; }
+          else if (hasPossible) { cellClass2 = 'hash-cell-possible'; bgStyle2 = ''; }
+          else { const t = Math.min((maxCol - 2) / 4, 1); bgStyle2 = `background:rgb(${Math.round(220+35*t)},${Math.round(120*(1-t))},30);`; cellClass2 = 'hash-cell-collision'; }
           const nodeLabel2 = m => esc(m.name||m.public_key.slice(0,8)) + (!m.role ? ' (?)' : '');
-          const tip = nodeCount === 0
-            ? hashTooltipHtml(`0x${hex}__`, 'No nodes in this group')
+          const tip2 = nodeCount === 0
+            ? `<div class="hash-matrix-tooltip-hex">0x${hex}__</div><div class="hash-matrix-tooltip-status">No nodes in this group</div>`
             : (info.collision_count || 0) === 0
-              ? hashTooltipHtml(`0x${hex}__`, `${nodeCount} node${nodeCount>1?'s':''} — no 2-byte collisions`)
-              : hashTooltipHtml(`0x${hex}__`,
-                  hasConfirmed ? (info.collision_count||0) + ' collision' + ((info.collision_count||0)>1?'s':'') : 'Possible conflict',
-                  Object.entries(info.two_byte_map||{}).filter(([,v])=>v.length>1).slice(0,4).map(([p,ns])=>`<div style="font-size:11px;padding:1px 0"><span style="color:${hasConfirmed?'var(--status-red)':'var(--status-yellow)'};font-family:var(--mono);font-weight:700">${p}</span> — ${ns.map(nodeLabel2).join(', ')}</div>`).join(''));
-          return hashCellTd(hex, cs, cls, bg, nodeCount, tip, maxCol > 0 ? '700' : '400');
-        },
-        420,
-        [
-          {cls: 'hash-cell-empty', style: 'border:1px solid var(--border)', text: 'No nodes in group'},
-          {cls: 'hash-cell-taken', text: 'Nodes present, no collision'},
-          {cls: 'hash-cell-possible', text: 'Possible conflict'},
-          {cls: 'hash-cell-collision', style: 'background:rgb(220,80,30)', text: 'Collision'}
-        ],
-        (td) => {
+              ? `<div class="hash-matrix-tooltip-hex">0x${hex}__</div><div class="hash-matrix-tooltip-status">${nodeCount} node${nodeCount>1?'s':''} — no 2-byte collisions</div>`
+              : `<div class="hash-matrix-tooltip-hex">0x${hex}__</div><div class="hash-matrix-tooltip-status">${hasConfirmed ? (info.collision_count||0) + ' collision' + ((info.collision_count||0)>1?'s':'') : 'Possible conflict'}</div><div class="hash-matrix-tooltip-nodes">${Object.entries(info.two_byte_map||{}).filter(([,v])=>v.length>1).slice(0,4).map(([p,ns])=>`<div style="font-size:11px;padding:1px 0"><span style="color:${hasConfirmed?'var(--status-red)':'var(--status-yellow)'};font-family:var(--mono);font-weight:700">${p}</span> — ${ns.map(nodeLabel2).join(', ')}</div>`).join('')}</div>`;
+          return `<td class="hash-cell ${cellClass2}${nodeCount ? ' hash-active' : ''}" data-hex="${hex}" data-tip="${tip2.replace(/"/g,'&quot;')}" style="width:${cs}px;height:${cs}px;text-align:center;${bgStyle2}border:1px solid var(--border);cursor:${nodeCount ? 'pointer' : 'default'};font-size:11px;font-weight:${maxCol > 0 ? '700' : '400'}">${hex}</td>`;
+      });
+      html += `<div id="hashDetail" style="flex:1;min-width:200px;max-width:420px;font-size:0.85em"></div></div>`;
+      html += hashMatrixLegendHtml([
+        {cls: 'hash-cell-empty', style: 'border:1px solid var(--border)', text: 'No nodes in group'},
+        {cls: 'hash-cell-taken', text: 'Nodes present, no collision'},
+        {cls: 'hash-cell-possible', text: 'Possible conflict'},
+        {cls: 'hash-cell-collision', style: 'background:rgb(220,80,30)', text: 'Collision'}
+      ]);
+      el.innerHTML = html;
+
+      el.querySelectorAll('.hash-active').forEach(td => {
+        td.addEventListener('click', () => {
           const hex = td.dataset.hex.toUpperCase();
           const info = twoByteCells[hex];
           const detail = document.getElementById('hashDetail');
@@ -1358,8 +1332,12 @@
             dhtml += '</div>';
           }
           detail.innerHTML = dhtml;
-        }
-      );
+          el.querySelectorAll('.hash-selected').forEach(c => c.classList.remove('hash-selected'));
+          td.classList.add('hash-selected');
+        });
+      });
+
+      initMatrixTooltip(el);
     }
   }
 
@@ -1370,15 +1348,13 @@
 
     if (!collisions.length) {
       const cleanMsg = bytes === 3
-        ? '✅ No 3-byte prefix collisions detected — all repeaters have unique 3-byte prefixes.'
+        ? '✅ No 3-byte prefix collisions detected — all nodes have unique 3-byte prefixes.'
         : `✅ No ${bytes}-byte collisions detected`;
       el.innerHTML = `<div class="text-muted" style="padding:8px">${cleanMsg}</div>`;
       return;
     }
 
     const showAppearances = bytes < 3;
-    const t50 = formatDistanceRound(50);
-    const t200 = formatDistanceRound(200);
     el.innerHTML = `<table class="analytics-table">
       <thead><tr>
         <th scope="col">Prefix</th>
@@ -1390,20 +1366,20 @@
       <tbody>${collisions.map(c => {
         let badge, tooltip;
         if (c.classification === 'local') {
-          badge = `<span class="badge" style="background:var(--status-green);color:#fff" title="All nodes within ${t50} — likely true collision, same RF neighborhood">🏘️ Local</span>`;
+          badge = '<span class="badge" style="background:var(--status-green);color:#fff" title="All nodes within 50km — likely true collision, same RF neighborhood">🏘️ Local</span>';
           tooltip = 'Nodes close enough for direct RF — probably genuine prefix collision';
         } else if (c.classification === 'regional') {
-          badge = `<span class="badge" style="background:var(--status-yellow);color:#fff" title="Nodes ${t50}–${t200} apart — edge of LoRa range, could be atmospheric">⚡ Regional</span>`;
+          badge = '<span class="badge" style="background:var(--status-yellow);color:#fff" title="Nodes 50–200km apart — edge of LoRa range, could be atmospheric">⚡ Regional</span>';
           tooltip = 'At edge of 915MHz range — could indicate atmospheric ducting or hilltop-to-hilltop links';
         } else if (c.classification === 'distant') {
-          badge = `<span class="badge" style="background:var(--status-red);color:#fff" title="Nodes >${t200} apart — beyond typical 915MHz range">🌐 Distant</span>`;
+          badge = '<span class="badge" style="background:var(--status-red);color:#fff" title="Nodes >200km apart — beyond typical 915MHz range">🌐 Distant</span>';
           tooltip = 'Beyond typical LoRa range — likely internet bridging, MQTT gateway, or separate mesh networks sharing prefix';
         } else {
           badge = '<span class="badge" style="background:#6b7280;color:#fff">❓ Unknown</span>';
           tooltip = 'Not enough coordinate data to classify';
         }
         const nodes = c.nodes || [];
-        const distStr = c.with_coords >= 2 ? formatDistanceRound(c.max_dist_km) : '<span class="text-muted">—</span>';
+        const distStr = c.with_coords >= 2 ? `${Math.round(c.max_dist_km)} km` : '<span class="text-muted">—</span>';
         return `<tr>
           <td class="mono">${c.prefix}</td>
           ${showAppearances ? `<td>${(c.appearances || 0).toLocaleString()}</td>` : ''}
@@ -1419,9 +1395,9 @@
       }).join('')}</tbody>
     </table>
     <div class="text-muted" style="padding:8px;font-size:0.8em">
-      <strong>🏘️ Local</strong> &lt;${t50}: true prefix collision, same mesh area &nbsp;
-      <strong>⚡ Regional</strong> ${t50}–${t200}: edge of LoRa range, possible atmospheric propagation &nbsp;
-      <strong>🌐 Distant</strong> &gt;${t200}: beyond 915MHz range — internet bridge, MQTT gateway, or separate networks
+      <strong>🏘️ Local</strong> &lt;50km: true prefix collision, same mesh area &nbsp;
+      <strong>⚡ Regional</strong> 50–200km: edge of LoRa range, possible atmospheric propagation &nbsp;
+      <strong>🌐 Distant</strong> &gt;200km: beyond 915MHz range — internet bridge, MQTT gateway, or separate networks
     </div>`;
   }
     async function renderSubpaths(el) {
@@ -1552,12 +1528,12 @@
                   : (() => { const R=6371, dLat=(b.lat-a.lat)*Math.PI/180, dLon=(b.lon-a.lon)*Math.PI/180, h=Math.sin(dLat/2)**2+Math.cos(a.lat*Math.PI/180)*Math.cos(b.lat*Math.PI/180)*Math.sin(dLon/2)**2; return R*2*Math.atan2(Math.sqrt(h),Math.sqrt(1-h)); })();
                 total += km;
                 const cls = km > 200 ? 'color:var(--status-red);font-weight:bold' : km > 50 ? 'color:var(--status-yellow)' : 'color:var(--status-green)';
-                dists.push(`<div style="padding:2px 0"><span style="${cls}">${formatDistance(km)}</span> <span class="text-muted">${esc(a.name)} → ${esc(b.name)}</span></div>`);
+                dists.push(`<div style="padding:2px 0"><span style="${cls}">${km < 1 ? (km*1000).toFixed(0)+'m' : km.toFixed(1)+'km'}</span> <span class="text-muted">${esc(a.name)} → ${esc(b.name)}</span></div>`);
               } else {
                 dists.push(`<div style="padding:2px 0"><span class="text-muted">? ${esc(a.name)} → ${esc(b.name)} (no coords)</span></div>`);
               }
             }
-            if (dists.length > 1) dists.push(`<div style="padding:4px 0;border-top:1px solid var(--border);margin-top:4px"><strong>Total: ${formatDistance(total)}</strong></div>`);
+            if (dists.length > 1) dists.push(`<div style="padding:4px 0;border-top:1px solid var(--border);margin-top:4px"><strong>Total: ${total < 1 ? (total*1000).toFixed(0)+'m' : total.toFixed(1)+'km'}</strong></div>`);
             return dists.join('');
           })()}
         </div>` : ''}
@@ -1794,17 +1770,16 @@
       let html = `<div class="analytics-grid">
         <div class="stat-card"><div class="stat-value">${s.totalHops.toLocaleString()}</div><div class="stat-label">Total Hops Analyzed</div></div>
         <div class="stat-card"><div class="stat-value">${s.totalPaths.toLocaleString()}</div><div class="stat-label">Paths Analyzed</div></div>
-        <div class="stat-card"><div class="stat-value">${formatDistance(s.avgDist)}</div><div class="stat-label">Avg Hop Distance</div></div>
-        <div class="stat-card"><div class="stat-value">${formatDistance(s.maxDist)}</div><div class="stat-label">Max Hop Distance</div></div>
+        <div class="stat-card"><div class="stat-value">${s.avgDist} km</div><div class="stat-label">Avg Hop Distance</div></div>
+        <div class="stat-card"><div class="stat-value">${s.maxDist} km</div><div class="stat-label">Max Hop Distance</div></div>
       </div>`;
 
       // Category stats
       const cats = data.catStats;
-      const distUnitLabel = getDistanceUnit() === 'mi' ? 'mi' : 'km';
-      html += `<div class="analytics-section"><h3>Distance by Link Type</h3><table class="data-table"><thead><tr><th scope="col">Type</th><th scope="col">Count</th><th scope="col">Avg (${distUnitLabel})</th><th scope="col">Median (${distUnitLabel})</th><th scope="col">Min (${distUnitLabel})</th><th scope="col">Max (${distUnitLabel})</th></tr></thead><tbody>`;
+      html += `<div class="analytics-section"><h3>Distance by Link Type</h3><table class="data-table"><thead><tr><th scope="col">Type</th><th scope="col">Count</th><th scope="col">Avg (km)</th><th scope="col">Median (km)</th><th scope="col">Min (km)</th><th scope="col">Max (km)</th></tr></thead><tbody>`;
       for (const [cat, st] of Object.entries(cats)) {
         if (!st.count) continue;
-        html += `<tr><td><strong>${esc(cat)}</strong></td><td>${st.count.toLocaleString()}</td><td>${formatDistance(st.avg)}</td><td>${formatDistance(st.median)}</td><td>${formatDistance(st.min)}</td><td>${formatDistance(st.max)}</td></tr>`;
+        html += `<tr><td><strong>${esc(cat)}</strong></td><td>${st.count.toLocaleString()}</td><td>${st.avg}</td><td>${st.median}</td><td>${st.min}</td><td>${st.max}</td></tr>`;
       }
       html += `</tbody></table></div>`;
 
@@ -1821,7 +1796,7 @@
       }
 
       // Top hops leaderboard
-      html += `<div class="analytics-section"><h3>🏆 Top 20 Longest Hops</h3><table class="data-table"><thead><tr><th scope="col">#</th><th scope="col">From</th><th scope="col">To</th><th scope="col">Distance (${distUnitLabel})</th><th scope="col">Type</th><th scope="col">SNR</th><th scope="col">Packet</th><th scope="col"></th></tr></thead><tbody>`;
+      html += `<div class="analytics-section"><h3>🏆 Top 20 Longest Hops</h3><table class="data-table"><thead><tr><th scope="col">#</th><th scope="col">From</th><th scope="col">To</th><th scope="col">Distance (km)</th><th scope="col">Type</th><th scope="col">SNR</th><th scope="col">Packet</th><th scope="col"></th></tr></thead><tbody>`;
       const top20 = data.topHops.slice(0, 20);
       top20.forEach((h, i) => {
         const fromLink = h.fromPk ? `<a href="#/nodes/${encodeURIComponent(h.fromPk)}" class="analytics-link">${esc(h.fromName)}</a>` : esc(h.fromName || '?');
@@ -1829,13 +1804,13 @@
         const snr = h.snr != null ? h.snr + ' dB' : '<span class="text-muted">—</span>';
         const pktLink = h.hash ? `<a href="#/packet/${encodeURIComponent(h.hash)}" class="analytics-link mono" style="font-size:0.85em">${esc(h.hash.slice(0, 12))}…</a>` : '—';
         const mapBtn = h.fromPk && h.toPk ? `<button class="btn-icon dist-map-hop" data-from="${esc(h.fromPk)}" data-to="${esc(h.toPk)}" title="View on map">🗺️</button>` : '';
-        html += `<tr><td>${i+1}</td><td>${fromLink}</td><td>${toLink}</td><td><strong>${formatDistance(h.dist)}</strong></td><td>${esc(h.type)}</td><td>${snr}</td><td>${pktLink}</td><td>${mapBtn}</td></tr>`;
+        html += `<tr><td>${i+1}</td><td>${fromLink}</td><td>${toLink}</td><td><strong>${h.dist}</strong></td><td>${esc(h.type)}</td><td>${snr}</td><td>${pktLink}</td><td>${mapBtn}</td></tr>`;
       });
       html += `</tbody></table></div>`;
 
       // Top paths
       if (data.topPaths.length) {
-        html += `<div class="analytics-section"><h3>🛤️ Top 10 Longest Multi-Hop Paths</h3><table class="data-table"><thead><tr><th scope="col">#</th><th scope="col">Total Distance (${distUnitLabel})</th><th scope="col">Hops</th><th scope="col">Route</th><th scope="col">Packet</th><th scope="col"></th></tr></thead><tbody>`;
+        html += `<div class="analytics-section"><h3>🛤️ Top 10 Longest Multi-Hop Paths</h3><table class="data-table"><thead><tr><th scope="col">#</th><th scope="col">Total Distance (km)</th><th scope="col">Hops</th><th scope="col">Route</th><th scope="col">Packet</th><th scope="col"></th></tr></thead><tbody>`;
         data.topPaths.slice(0, 10).forEach((p, i) => {
           const route = p.hops.map(h => esc(h.fromName)).concat(esc(p.hops[p.hops.length-1].toName)).join(' → ');
           const pktLink = p.hash ? `<a href="#/packet/${encodeURIComponent(p.hash)}" class="analytics-link mono" style="font-size:0.85em">${esc(p.hash.slice(0, 12))}…</a>` : '—';
@@ -1844,7 +1819,7 @@
           p.hops.forEach(h => { if (h.fromPk && !pathPks.includes(h.fromPk)) pathPks.push(h.fromPk); });
           if (p.hops.length && p.hops[p.hops.length-1].toPk) { const last = p.hops[p.hops.length-1].toPk; if (!pathPks.includes(last)) pathPks.push(last); }
           const mapBtn = pathPks.length >= 2 ? `<button class="btn-icon dist-map-path" data-hops='${JSON.stringify(pathPks)}' title="View on map">🗺️</button>` : '';
-          html += `<tr><td>${i+1}</td><td><strong>${formatDistance(p.totalDist)}</strong></td><td>${p.hopCount}</td><td style="font-size:0.9em">${route}</td><td>${pktLink}</td><td>${mapBtn}</td></tr>`;
+          html += `<tr><td>${i+1}</td><td><strong>${p.totalDist}</strong></td><td>${p.hopCount}</td><td style="font-size:0.9em">${route}</td><td>${pktLink}</td><td>${mapBtn}</td></tr>`;
         });
         html += `</tbody></table></div>`;
       }
@@ -1872,7 +1847,7 @@
     }
   }
 
-function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _ngState.animId) { cancelAnimationFrame(_ngState.animId); } _ngState = null; if (_themeRefreshHandler) { window.removeEventListener('theme-refresh', _themeRefreshHandler); _themeRefreshHandler = null; } }
+function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _ngState.animId) { cancelAnimationFrame(_ngState.animId); } _ngState = null; }
 
   // Expose for testing
   if (typeof window !== 'undefined') {
@@ -1881,7 +1856,6 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     window._analyticsSaveChannelSort = saveChannelSort;
     window._analyticsChannelTbodyHtml = channelTbodyHtml;
     window._analyticsChannelTheadHtml = channelTheadHtml;
-    window._analyticsRfNFColumnChart = rfNFColumnChart;
   }
 
   // ─── Neighbor Graph Tab ─────────────────────────────────────────────────────
@@ -2356,13 +2330,10 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
         nodeMap.set(n.public_key, n);
       }
     });
-    const allNodes = [...nodeMap.values()];
-    // Only repeaters matter for prefix collisions — they relay packets using hash prefixes.
-    // Companions, rooms, and sensors don't route, so their prefix collisions are harmless.
-    const nodes = allNodes.filter(n => n.role === 'repeater');
+    const nodes = [...nodeMap.values()];
 
     if (nodes.length === 0) {
-      el.innerHTML = `<div class="analytics-card"><p class="text-muted">No repeaters in the network yet. Any prefix is available!</p></div>`;
+      el.innerHTML = `<div class="analytics-card"><p class="text-muted">No nodes in the network yet. Any prefix is available!</p></div>`;
       return;
     }
 
@@ -2391,11 +2362,11 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     const totalNodes = nodes.length;
     let rec, recDetail;
     if (totalNodes < 20) {
-      rec = '1-byte'; recDetail = `With only ${totalNodes} repeaters, 1-byte prefixes have low collision risk.`;
+      rec = '1-byte'; recDetail = `With only ${totalNodes} nodes, 1-byte prefixes have low collision risk.`;
     } else if (totalNodes < 500) {
-      rec = '2-byte'; recDetail = `With ${totalNodes} repeaters, 2-byte prefixes are recommended to avoid collisions.`;
+      rec = '2-byte'; recDetail = `With ${totalNodes} nodes, 2-byte prefixes are recommended to avoid collisions.`;
     } else {
-      rec = '2-byte'; recDetail = `With ${totalNodes} repeaters, 2-byte prefixes are strongly recommended.`;
+      rec = '2-byte'; recDetail = `With ${totalNodes} nodes, 2-byte prefixes are strongly recommended.`;
     }
 
     // URL params for pre-fill / auto-run
@@ -2404,7 +2375,7 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     const initGenerate = hashParams.get('generate') || '';
 
     const regionNote = regionLabel
-      ? `<p class="text-muted" style="font-size:0.85em;margin:4px 0 0">Showing data for region: <strong>${esc(regionLabel)}</strong>. <a href="#/analytics?tab=prefix-tool" style="color:var(--accent)">Check all repeaters →</a></p>`
+      ? `<p class="text-muted" style="font-size:0.85em;margin:4px 0 0">Showing data for region: <strong>${esc(regionLabel)}</strong>. <a href="#/analytics?tab=prefix-tool" style="color:var(--accent)">Check all nodes →</a></p>`
       : '';
 
     el.innerHTML = `
@@ -2417,7 +2388,7 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
           ${regionNote}
           <div style="display:flex;gap:12px;flex-wrap:wrap;margin:12px 0 16px">
             <div class="analytics-stat-card" style="flex:1;min-width:110px">
-              <div class="analytics-stat-label">Total repeaters</div>
+              <div class="analytics-stat-label">Total nodes</div>
               <div class="analytics-stat-value">${totalNodes.toLocaleString()}</div>
             </div>
             ${[1, 2, 3].map(b => `
@@ -2434,15 +2405,10 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
               </div>
             </div>`).join('')}
           </div>
-          <div style="background:var(--bg-secondary,var(--bg));border:1px solid var(--border);border-radius:6px;padding:10px 14px;margin-bottom:12px">
+          <div style="background:var(--bg-secondary,var(--bg));border:1px solid var(--border);border-radius:6px;padding:10px 14px">
             <strong>Recommendation: ${rec} prefixes</strong> — ${recDetail}
             <span class="text-muted" style="font-size:0.8em;display:block;margin-top:4px">Hash size is configured per-node in firmware. Changing requires reflashing.</span>
           </div>
-          <div style="background:var(--bg-secondary,var(--bg));border:1px solid var(--border);border-radius:6px;padding:10px 14px;font-size:0.85em">
-            <strong>ℹ️ About these numbers:</strong> This tool checks <em>repeater</em> public key prefixes regardless of their configured hash size. Only repeaters are included because they are the nodes that relay packets using hash-based addressing.
-            The <a href="#/analytics?tab=collisions" style="color:var(--accent)">Hash Issues</a> tab shows only <em>operational</em> collisions — nodes that actually use the same hash size and are repeaters.
-            A collision shown here may not appear in Hash Issues if the nodes use a different hash size.
-          </div>
         </div>
       </div>
 
@@ -2488,9 +2454,8 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     function nodeEntry(n) {
       const name = esc(n.name || n.public_key.slice(0, 12));
       const role = n.role ? `<span class="text-muted" style="font-size:0.82em">${esc(n.role)}</span>` : '';
-      const hs = n.hash_size ? ` <span class="text-muted" style="font-size:0.78em;opacity:0.7">${n.hash_size}B hash</span>` : '';
       const when = n.last_seen ? ` <span class="text-muted" style="font-size:0.8em">${new Date(n.last_seen).toLocaleDateString()}</span>` : '';
-      return `<div style="padding:3px 0"><a href="#/nodes/${encodeURIComponent(n.public_key)}" class="analytics-link">${name}</a> ${role}${hs}${when}</div>`;
+      return `<div style="padding:3px 0"><a href="#/nodes/${encodeURIComponent(n.public_key)}" class="analytics-link">${name}</a> ${role}${when}</div>`;
     }
 
     function severityBadge(count) {
@@ -2933,7 +2898,7 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
       // Render noise floor chart
       const nfEl = document.getElementById('rfDetailNFChart');
       if (nfEl && nfData.length > 1) {
-        nfEl.innerHTML = rfNFColumnChart(nfData, nfEl.clientWidth || 700, 180, reboots, minT, maxT);
+        nfEl.innerHTML = rfNFLineChart(nfData, nfEl.clientWidth || 700, 180, reboots, minT, maxT);
       } else if (nfEl) {
         nfEl.innerHTML = '<span class="text-muted">Not enough noise floor data</span>';
       }
@@ -2980,20 +2945,6 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
   }
 
   // Shared helper: render X-axis time labels
-  function rfTooltipCircles(data, sx, sy, label, unit, formatV) {
-    let svg = '';
-    formatV = formatV || (v => v.toFixed(1));
-    data.forEach(d => {
-      const t = new Date(d.t);
-      const x = sx(t.getTime());
-      const y = sy(d.v);
-      const ts = t.toISOString().replace('T', ' ').replace(/\.\d+Z/, ' UTC');
-      const tip = `${label}: ${formatV(d.v)}${unit}\n${ts}`;
-      svg += `<circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="8" fill="transparent" stroke="none" pointer-events="all"><title>${tip}</title></circle>`;
-    });
-    return svg;
-  }
-
   function rfXAxisLabels(data, sx, h, pad) {
     let svg = '';
     const xTicks = Math.min(6, data.length);
@@ -3016,26 +2967,18 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     const minT = sharedMinT, maxT = sharedMaxT;
     const rangeT = maxT - minT || 1;
 
-    // Auto-scale Y-axis to data range (20% headroom, min 1%)
-    let dataMax = 0;
-    for (let i = 0; i < txData.length; i++) { if (txData[i].v > dataMax) dataMax = txData[i].v; }
-    for (let i = 0; i < rxData.length; i++) { if (rxData[i].v > dataMax) dataMax = rxData[i].v; }
-    const yMax = Math.max(dataMax * 1.2, 1);
-
     const sx = t => pad.left + ((t - minT) / rangeT) * cw;
-    const sy = v => pad.top + ch - (v / yMax) * ch;
+    const sy = v => pad.top + ch - (v / 100) * ch; // 0-100%
 
     let svg = `<svg viewBox="0 0 ${w} ${h}" style="width:100%;max-height:${h}px" role="img" aria-label="Airtime chart"><title>Airtime %</title>`;
 
     // Chart title
     svg += `<text x="${pad.left}" y="12" font-size="10" fill="var(--text-muted)" font-weight="600">Airtime %</text>`;
 
-    // Y-axis: 5 ticks from 0 to yMax
-    const yTicks = 4;
-    for (let i = 0; i <= yTicks; i++) {
-      const v = yMax * i / yTicks;
-      const y = sy(v);
-      svg += `<text x="${pad.left - 4}" y="${(y + 3).toFixed(1)}" text-anchor="end" font-size="9" fill="var(--text-muted)">${v.toFixed(1)}</text>`;
+    // Y-axis: 0, 25, 50, 75, 100
+    for (let pct = 0; pct <= 100; pct += 25) {
+      const y = sy(pct);
+      svg += `<text x="${pad.left - 4}" y="${(y + 3).toFixed(1)}" text-anchor="end" font-size="9" fill="var(--text-muted)">${pct}</text>`;
       svg += `<line x1="${pad.left}" y1="${y.toFixed(1)}" x2="${w - pad.right}" y2="${y.toFixed(1)}" stroke="var(--border)" stroke-width="0.3"/>`;
     }
 
@@ -3076,10 +3019,6 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     const allData = txData.length >= rxData.length ? txData : rxData;
     svg += rfXAxisLabels(allData, sx, h, pad);
 
-    // Hover tooltips
-    svg += rfTooltipCircles(txData, sx, sy, 'TX', '%');
-    svg += rfTooltipCircles(rxData, sx, sy, 'RX', '%');
-
     svg += '</svg>';
     return svg;
   }
@@ -3129,9 +3068,6 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     // X-axis labels
     svg += rfXAxisLabels(errData, sx, h, pad);
 
-    // Hover tooltips
-    svg += rfTooltipCircles(errData, sx, sy, 'Err', '%', v => v.toFixed(2));
-
     svg += '</svg>';
     return svg;
   }
@@ -3190,20 +3126,11 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     // X-axis labels
     svg += rfXAxisLabels(battData, sx, h, pad);
 
-    // Hover tooltips
-    svg += rfTooltipCircles(battData, sx, sy, 'Batt', 'V', v => (v/1000).toFixed(2));
-
     svg += '</svg>';
     return svg;
   }
 
-  /**
-   * Noise floor column chart — color-coded bars (green/yellow/red) by threshold.
-   * Replaces the old line chart for better discrete-sample readability.
-   * Thresholds: green (< -100 dBm), yellow (-100 to -85 dBm), red (≥ -85 dBm).
-   */
-  function rfNFColumnChart(data, w, h, reboots, sharedMinT, sharedMaxT) {
-    if (!data || !data.length) return '<svg viewBox="0 0 1 1"></svg>';
+  function rfNFLineChart(data, w, h, reboots, sharedMinT, sharedMaxT) {
     reboots = reboots || [];
     const pad = { top: 20, right: 40, bottom: 30, left: 55 };
     const cw = w - pad.left - pad.right;
@@ -3214,33 +3141,34 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     const maxT = sharedMaxT != null ? sharedMaxT : Math.max(...data.map(d => new Date(d.t).getTime()));
     const minV = Math.min(...values);
     const maxV = Math.max(...values);
-    // Guard against zero range (single data point or constant values):
-    // use a ±5 dBm window so bars are visible and centered in the chart
-    const rawRangeV = maxV - minV;
-    const rangeV = rawRangeV || 10;
-    const adjMinV = rawRangeV ? minV : minV - 5;
+    const rangeV = maxV - minV || 1;
     const rangeT = maxT - minT || 1;
 
     const sx = t => pad.left + ((t - minT) / rangeT) * cw;
-    const sy = v => pad.top + ch - ((v - adjMinV) / rangeV) * ch;
+    const sy = v => pad.top + ch - ((v - minV) / rangeV) * ch;
 
-    // Column width: proportional to chart width / data points, min 2px, gap of 1px
-    const colW = Math.max(2, Math.floor(cw / data.length) - 1);
+    const pts = data.map(d => `${sx(new Date(d.t).getTime()).toFixed(1)},${sy(d.v).toFixed(1)}`).join(' ');
 
-    const times = data.map(d => new Date(d.t).getTime());
-
-    let svg = `<svg viewBox="0 0 ${w} ${h}" style="width:100%;max-height:${h}px" role="img" aria-label="Noise floor column chart"><title>Noise floor over time</title>`;
-
-    // Inline style for hover highlighting
-    svg += `<style>.nf-bar{transition:opacity 0.05s}.nf-bar:hover{opacity:0.75;stroke:var(--text);stroke-width:1}</style>`;
+    let svg = `<svg viewBox="0 0 ${w} ${h}" style="width:100%;max-height:${h}px" role="img" aria-label="Noise floor line chart"><title>Noise floor over time</title>`;
 
     // Chart title
     svg += `<text x="${pad.left}" y="12" font-size="10" fill="var(--text-muted)" font-weight="600">Noise Floor dBm</text>`;
 
-    // Y-axis labels + grid lines
+    // Reference lines
+    const refLines = [-100, -85];
+    const refLabels = ['-100 warning', '-85 critical'];
+    refLines.forEach((ref, i) => {
+      if (ref >= minV && ref <= maxV) {
+        const y = sy(ref);
+        svg += `<line x1="${pad.left}" y1="${y.toFixed(1)}" x2="${w - pad.right}" y2="${y.toFixed(1)}" stroke="var(--text-muted)" stroke-width="0.5" stroke-dasharray="4,2"/>`;
+        svg += `<text x="${w - pad.right + 2}" y="${(y + 3).toFixed(1)}" font-size="9" fill="var(--text-muted)">${refLabels[i]}</text>`;
+      }
+    });
+
+    // Y-axis labels
     const yTicks = 5;
     for (let i = 0; i <= yTicks; i++) {
-      const v = adjMinV + (rangeV * i / yTicks);
+      const v = minV + (rangeV * i / yTicks);
       const y = sy(v);
       svg += `<text x="${pad.left - 4}" y="${(y + 3).toFixed(1)}" text-anchor="end" font-size="9" fill="var(--text-muted)">${v.toFixed(0)}</text>`;
       svg += `<line x1="${pad.left}" y1="${y.toFixed(1)}" x2="${w - pad.right}" y2="${y.toFixed(1)}" stroke="var(--border)" stroke-width="0.3"/>`;
@@ -3252,39 +3180,21 @@ function destroy() { _analyticsData = {}; _channelData = null; if (_ngState && _
     // X-axis labels
     svg += rfXAxisLabels(data, sx, h, pad);
 
-    // Color-coded columns
-    for (let i = 0; i < data.length; i++) {
-      const t = times[i];
-      const v = data[i].v;
-      const x = sx(t) - colW / 2;
-      const y = sy(v);
-      const barH = pad.top + ch - y;
+    // Data polyline
+    svg += `<polyline points="${pts}" fill="none" stroke="var(--accent)" stroke-width="1.5"/>`;
 
-      // Threshold color: green < -100, yellow -100 to -85, red >= -85
-      let color;
-      if (v < -100) color = 'var(--success, #22c55e)';
-      else if (v < -85) color = 'var(--warning, #eab308)';
-      else color = 'var(--danger, #ef4444)';
-
-      const ts = new Date(data[i].t).toISOString().replace('T', ' ').replace(/\.\d+Z/, ' UTC');
-      const tip = `NF: ${v.toFixed(1)} dBm\n${ts}`;
-
-      svg += `<rect class="nf-bar" x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${colW}" height="${Math.max(0, barH).toFixed(1)}" fill="${color}" rx="0.5"><title>${tip}</title></rect>`;
-    }
+    // Direct labels: min and max points
+    const times = data.map(d => new Date(d.t).getTime());
+    const maxIdx = values.indexOf(maxV);
+    const minIdx = values.indexOf(minV);
+    svg += `<circle cx="${sx(times[maxIdx]).toFixed(1)}" cy="${sy(maxV).toFixed(1)}" r="3" fill="var(--danger, red)"/>`;
+    svg += `<text x="${sx(times[maxIdx]).toFixed(1)}" y="${(sy(maxV) - 6).toFixed(1)}" text-anchor="middle" font-size="9" fill="var(--danger, red)">${maxV.toFixed(1)}</text>`;
+    svg += `<circle cx="${sx(times[minIdx]).toFixed(1)}" cy="${sy(minV).toFixed(1)}" r="3" fill="var(--success, green)"/>`;
+    svg += `<text x="${sx(times[minIdx]).toFixed(1)}" y="${(sy(minV) + 14).toFixed(1)}" text-anchor="middle" font-size="9" fill="var(--success, green)">${minV.toFixed(1)}</text>`;
 
     // Y-axis label
     svg += `<text x="12" y="${(h / 2)}" text-anchor="middle" font-size="10" fill="var(--text-muted)" transform="rotate(-90,12,${h/2})">dBm</text>`;
 
-    // Legend
-    const legendY = pad.top + 2;
-    const legendX = w - pad.right - 140;
-    svg += `<rect x="${legendX}" y="${legendY}" width="8" height="8" fill="var(--success, #22c55e)" rx="1"/>`;
-    svg += `<text x="${legendX + 11}" y="${legendY + 7}" font-size="8" fill="var(--text-muted)">&lt; -100</text>`;
-    svg += `<rect x="${legendX + 48}" y="${legendY}" width="8" height="8" fill="var(--warning, #eab308)" rx="1"/>`;
-    svg += `<text x="${legendX + 59}" y="${legendY + 7}" font-size="8" fill="var(--text-muted)">-100…-85</text>`;
-    svg += `<rect x="${legendX + 105}" y="${legendY}" width="8" height="8" fill="var(--danger, #ef4444)" rx="1"/>`;
-    svg += `<text x="${legendX + 116}" y="${legendY + 7}" font-size="8" fill="var(--text-muted)">≥ -85</text>`;
-
     svg += '</svg>';
     return svg;
   }

public/app.js

@@ -104,46 +104,6 @@ function timeAgo(iso) {
   return value + suffix + ' ago';
 }
 
-function getHashParams() {
-  return new URLSearchParams(location.hash.split('?')[1] || '');
-}
-
-function getDistanceUnit() {
-  var stored = localStorage.getItem('meshcore-distance-unit');
-  if (stored === 'km') return 'km';
-  if (stored === 'mi') return 'mi';
-  // 'auto' or no value — locale detection
-  var milesLocales = ['en-us', 'en-gb'];
-  var lang = (typeof navigator !== 'undefined' && navigator.language || '').toLowerCase();
-  for (var i = 0; i < milesLocales.length; i++) {
-    if (lang === milesLocales[i] || lang.startsWith(milesLocales[i] + '-')) return 'mi';
-  }
-  return 'km';
-}
-window.getDistanceUnit = getDistanceUnit;
-
-function formatDistance(km) {
-  if (km == null || isNaN(+km)) return '—';
-  var d = +km;
-  var unit = getDistanceUnit();
-  if (unit === 'mi') {
-    var mi = d / 1.60934;
-    if (mi < 0.1) return Math.round(mi * 5280) + ' ft';
-    return mi.toFixed(1) + ' mi';
-  }
-  if (d < 1) return Math.round(d * 1000) + ' m';
-  return d.toFixed(1) + ' km';
-}
-window.formatDistance = formatDistance;
-
-function formatDistanceRound(km) {
-  if (km == null || isNaN(+km)) return '—';
-  var unit = getDistanceUnit();
-  if (unit === 'mi') return Math.round(+km / 1.60934) + ' mi';
-  return Math.round(+km) + ' km';
-}
-window.formatDistanceRound = formatDistanceRound;
-
 function getTimestampMode() {
   const saved = localStorage.getItem('meshcore-timestamp-mode');
   if (saved === 'ago' || saved === 'absolute') return saved;
@@ -512,12 +472,6 @@ function navigate() {
     const ms = performance.now() - t0;
     if (ms > 100) console.warn(`[SLOW PAGE] ${basePage} init took ${Math.round(ms)}ms`);
     app.classList.remove('page-enter'); void app.offsetWidth; app.classList.add('page-enter');
-    // #630-7: SPA focus management — move focus to first heading or main content
-    requestAnimationFrame(function() {
-      var heading = app.querySelector('h1, h2, h3, [role="heading"]');
-      if (heading) { heading.setAttribute('tabindex', '-1'); heading.focus({ preventScroll: true }); }
-      else { app.setAttribute('tabindex', '-1'); app.focus({ preventScroll: true }); }
-    });
   } else {
     app.innerHTML = `<div style="padding:40px;text-align:center;color:#6b7280"><h2>${route}</h2><p>Page not yet implemented.</p></div>`;
   }

public/channel-color-picker.js

@@ -1,273 +0,0 @@
-/**
- * Channel Color Picker — Simplified popover with 8-color constrained palette (#674)
- *
- * Click a color dot next to channel names (channels page, live feed) to open picker.
- * Right-click on live feed items retained as power-user shortcut (desktop only).
- * No long-press. No custom color input. 8 preset colors.
- *
- * Uses ChannelColors.set/get/remove from channel-colors.js.
- */
-(function() {
-  'use strict';
-
-  // 8 maximally-distinct colors on dark backgrounds (#674 Tufte spec)
-  var CHANNEL_PALETTE = [
-    '#ef4444', // red
-    '#f97316', // orange
-    '#eab308', // yellow
-    '#22c55e', // green
-    '#06b6d4', // cyan
-    '#3b82f6', // blue
-    '#8b5cf6', // violet
-    '#ec4899'  // pink
-  ];
-
-  var popoverEl = null;
-  var currentChannel = null;
-
-  function createPopover() {
-    if (popoverEl) return popoverEl;
-    var el = document.createElement('div');
-    el.className = 'cc-picker-popover';
-    el.setAttribute('role', 'dialog');
-    el.setAttribute('aria-label', 'Channel color picker');
-    el.style.display = 'none';
-    el.innerHTML =
-      '<div class="cc-picker-swatches" role="group" aria-label="Color swatches"></div>' +
-      '<button class="cc-picker-clear">Clear color</button>';
-
-    // Build swatches
-    var swatchContainer = el.querySelector('.cc-picker-swatches');
-    for (var i = 0; i < CHANNEL_PALETTE.length; i++) {
-      var sw = document.createElement('button');
-      sw.className = 'cc-swatch';
-      sw.style.background = CHANNEL_PALETTE[i];
-      sw.setAttribute('data-color', CHANNEL_PALETTE[i]);
-      sw.setAttribute('aria-label', CHANNEL_PALETTE[i]);
-      sw.title = CHANNEL_PALETTE[i];
-      sw.setAttribute('tabindex', '0');
-      swatchContainer.appendChild(sw);
-    }
-
-    // Event: swatch click
-    swatchContainer.addEventListener('click', function(e) {
-      var btn = e.target.closest('.cc-swatch');
-      if (!btn) return;
-      assignColor(btn.getAttribute('data-color'));
-    });
-
-    // Keyboard navigation for swatches
-    swatchContainer.addEventListener('keydown', function(e) {
-      var btn = e.target.closest('.cc-swatch');
-      if (!btn) return;
-      var swatches = swatchContainer.querySelectorAll('.cc-swatch');
-      var idx = Array.prototype.indexOf.call(swatches, btn);
-      if (idx < 0) return;
-      var next = -1;
-      if (e.key === 'ArrowRight' || e.key === 'ArrowDown') next = (idx + 1) % swatches.length;
-      else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') next = (idx - 1 + swatches.length) % swatches.length;
-      else if (e.key === 'Enter' || e.key === ' ') { assignColor(btn.getAttribute('data-color')); e.preventDefault(); return; }
-      if (next >= 0) { swatches[next].focus(); e.preventDefault(); }
-    });
-
-    // Event: clear
-    el.querySelector('.cc-picker-clear').addEventListener('click', function() {
-      if (currentChannel && window.ChannelColors) {
-        window.ChannelColors.remove(currentChannel);
-        refreshVisibleRows();
-      }
-      hidePopover();
-    });
-
-    // Prevent right-click on the popover itself
-    el.addEventListener('contextmenu', function(e) { e.preventDefault(); });
-
-    document.body.appendChild(el);
-    popoverEl = el;
-    return el;
-  }
-
-  function assignColor(color) {
-    if (currentChannel && window.ChannelColors) {
-      window.ChannelColors.set(currentChannel, color);
-      refreshVisibleRows();
-    }
-    hidePopover();
-  }
-
-  function showPopover(channel, x, y) {
-    var el = createPopover();
-    currentChannel = channel;
-
-    // Highlight current color
-    var current = window.ChannelColors ? window.ChannelColors.get(channel) : null;
-    var swatches = el.querySelectorAll('.cc-swatch');
-    for (var i = 0; i < swatches.length; i++) {
-      swatches[i].classList.toggle('cc-swatch-active', swatches[i].getAttribute('data-color') === current);
-    }
-
-    // Show/hide clear button
-    el.querySelector('.cc-picker-clear').style.display = current ? '' : 'none';
-
-    // Position
-    el.style.display = '';
-    var isTouch = window.matchMedia('(pointer: coarse)').matches;
-    if (!isTouch) {
-      el.style.left = '0';
-      el.style.top = '0';
-      var rect = el.getBoundingClientRect();
-      var pw = rect.width;
-      var ph = rect.height;
-      var vw = window.innerWidth;
-      var vh = window.innerHeight;
-      var finalX = x + pw > vw ? Math.max(0, vw - pw - 8) : x;
-      var finalY = y + ph > vh ? Math.max(0, vh - ph - 8) : y;
-      el.style.left = finalX + 'px';
-      el.style.top = finalY + 'px';
-    }
-
-    // Lock background scroll while popover is open
-    document.body.style.overflow = 'hidden';
-
-    // Focus first swatch for keyboard accessibility
-    var firstSwatch = el.querySelector('.cc-swatch');
-    if (firstSwatch) setTimeout(function() { firstSwatch.focus(); }, 0);
-
-    // Listen for outside click / Escape
-    setTimeout(function() {
-      document.addEventListener('click', onOutsideClick, true);
-      document.addEventListener('keydown', onEscape, true);
-    }, 0);
-  }
-
-  function hidePopover() {
-    if (popoverEl) popoverEl.style.display = 'none';
-    currentChannel = null;
-    document.body.style.overflow = '';
-    document.removeEventListener('click', onOutsideClick, true);
-    document.removeEventListener('keydown', onEscape, true);
-  }
-
-  function onOutsideClick(e) {
-    if (popoverEl && !popoverEl.contains(e.target)) {
-      hidePopover();
-    }
-  }
-
-  function onEscape(e) {
-    if (e.key === 'Escape') {
-      hidePopover();
-      e.stopPropagation();
-    }
-    // Trap Tab within the popover
-    if (e.key === 'Tab' && popoverEl && popoverEl.style.display !== 'none') {
-      var focusable = popoverEl.querySelectorAll('button, [tabindex]');
-      if (focusable.length === 0) return;
-      var first = focusable[0];
-      var last = focusable[focusable.length - 1];
-      if (e.shiftKey && document.activeElement === first) {
-        last.focus(); e.preventDefault();
-      } else if (!e.shiftKey && document.activeElement === last) {
-        first.focus(); e.preventDefault();
-      }
-    }
-  }
-
-  /** Refresh channel color styles on all visible feed items, channel list, and packet rows. */
-  function refreshVisibleRows() {
-    if (!window.ChannelColors) return;
-
-    // Live feed items
-    var feedItems = document.querySelectorAll('.live-feed-item');
-    for (var i = 0; i < feedItems.length; i++) {
-      var item = feedItems[i];
-      var ch = item._ccChannel;
-      if (!ch) continue;
-      var color = window.ChannelColors.get(ch);
-      item.style.borderLeft = color ? '3px solid ' + color : '';
-    }
-
-    // Update color dots everywhere
-    var dots = document.querySelectorAll('.ch-color-dot');
-    for (var j = 0; j < dots.length; j++) {
-      var dot = dots[j];
-      var dotCh = dot.getAttribute('data-channel');
-      if (!dotCh) continue;
-      var dotColor = window.ChannelColors.get(dotCh);
-      dot.style.background = dotColor || '';
-    }
-
-    // Channel list items — update border
-    var chItems = document.querySelectorAll('.ch-item[data-hash]');
-    for (var k = 0; k < chItems.length; k++) {
-      var chItem = chItems[k];
-      var hash = chItem.getAttribute('data-hash');
-      if (!hash) continue;
-      var chColor = window.ChannelColors.get(hash);
-      chItem.style.borderLeft = chColor ? '3px solid ' + chColor : '';
-    }
-
-    // Packets table — trigger re-render via custom event
-    document.dispatchEvent(new CustomEvent('channel-colors-changed'));
-  }
-
-  /**
-   * Install context-menu (right-click) handler on the live feed.
-   * No long-press — color dots handle mobile interaction.
-   */
-  function installLiveFeedHandlers() {
-    var feed = document.getElementById('liveFeed');
-    if (!feed) return;
-
-    // Click on color dot opens picker (#674)
-    feed.addEventListener('click', function(e) {
-      var dot = e.target.closest('.feed-color-dot');
-      if (!dot) return;
-      e.stopPropagation();
-      var ch = dot.getAttribute('data-channel');
-      if (ch) showPopover(ch, e.clientX, e.clientY);
-    });
-
-    feed.addEventListener('contextmenu', function(e) {
-      var item = e.target.closest('.live-feed-item');
-      if (!item || !item._ccChannel) return;
-      e.preventDefault();
-      showPopover(item._ccChannel, e.clientX, e.clientY);
-    });
-  }
-
-  /**
-   * Install context-menu handler on the packets table.
-   */
-  function installPacketsTableHandlers() {
-    var table = document.getElementById('packetsTableBody');
-    if (!table) return;
-
-    table.addEventListener('contextmenu', function(e) {
-      var row = e.target.closest('tr');
-      if (!row) return;
-      var chanTag = row.querySelector('.chan-tag');
-      if (chanTag) {
-        var ch = chanTag.textContent.trim();
-        if (ch) {
-          e.preventDefault();
-          showPopover(ch, e.clientX, e.clientY);
-          return;
-        }
-      }
-    });
-  }
-
-  // Export
-  window.ChannelColorPicker = {
-    install: function() {
-      installLiveFeedHandlers();
-      installPacketsTableHandlers();
-    },
-    installLiveFeed: installLiveFeedHandlers,
-    installPacketsTable: installPacketsTableHandlers,
-    show: showPopover,
-    hide: hidePopover,
-    PALETTE: CHANNEL_PALETTE
-  };
-})();

public/channel-colors.js

@@ -94,8 +94,8 @@
     if (!channel) return '';
     var color = getChannelColor(channel);
     if (!color) return '';
-    // 3px left border only — minimal Tufte-style encoding (#674)
-    return 'border-left:3px solid ' + color + ';';
+    // 4px left border + 10% opacity background tint
+    return 'border-left:4px solid ' + color + ';background:' + color + '1a;';
   }
 
   // Export to window for use by live.js and packets.js

public/channels.js

@@ -171,11 +171,8 @@
   async function showNodeDetail(name) {
     _nodePanelTrigger = document.activeElement;
     if (_focusTrapCleanup) { _focusTrapCleanup(); _focusTrapCleanup = null; }
-    var _capturedHash = selectedHash;
     const node = await lookupNode(name);
     selectedNode = name;
-    var _chBase = _capturedHash ? '#/channels/' + encodeURIComponent(_capturedHash) : '#/channels';
-    history.replaceState(null, '', _chBase + '?node=' + encodeURIComponent(name));
 
     let panel = document.getElementById('chNodePanel');
     if (!panel) {
@@ -237,8 +234,6 @@
     const panel = document.getElementById('chNodePanel');
     if (panel) panel.classList.remove('open');
     selectedNode = null;
-    var _chRestoreUrl = selectedHash ? '#/channels/' + encodeURIComponent(selectedHash) : '#/channels';
-    history.replaceState(null, '', _chRestoreUrl);
     if (_nodePanelTrigger && typeof _nodePanelTrigger.focus === 'function') {
       _nodePanelTrigger.focus();
       _nodePanelTrigger = null;
@@ -319,9 +314,6 @@
   let regionChangeHandler = null;
 
   function init(app, routeParam) {
-    var _initUrlParams = getHashParams();
-    var _pendingNode = _initUrlParams.get('node');
-
     app.innerHTML = `<div class="ch-layout">
       <div class="ch-sidebar" aria-label="Channel list">
         <div class="ch-sidebar-header">
@@ -355,9 +347,8 @@
     });
 
     loadObserverRegions();
-    loadChannels().then(async function () {
-      if (routeParam) await selectChannel(routeParam);
-      if (_pendingNode && _pendingNode.length < 200) await showNodeDetail(_pendingNode);
+    loadChannels().then(() => {
+      if (routeParam) selectChannel(routeParam);
     });
 
     // #89: Sidebar resize handle
@@ -403,14 +394,6 @@
 
     // Event delegation for channel selection (touch-friendly)
     document.getElementById('chList').addEventListener('click', (e) => {
-      // Color dot click — open picker, don't select channel
-      const dot = e.target.closest('.ch-color-dot');
-      if (dot && window.ChannelColorPicker) {
-        e.stopPropagation();
-        var ch = dot.getAttribute('data-channel');
-        if (ch) ChannelColorPicker.show(ch, e.clientX, e.clientY);
-        return;
-      }
       const item = e.target.closest('.ch-item[data-hash]');
       if (item) selectChannel(item.dataset.hash);
     });
@@ -687,18 +670,12 @@
         : `${ch.messageCount} messages`;
       const sel = selectedHash === ch.hash ? ' selected' : '';
       const abbr = name.startsWith('#') ? name.slice(0, 3) : name.slice(0, 2).toUpperCase();
-      // Channel color dot for color picker (#674)
-      const chColor = window.ChannelColors ? window.ChannelColors.get(ch.hash) : null;
-      const dotStyle = chColor ? ` style="background:${chColor}"` : '';
-      // Left border for assigned color
-      const borderStyle = chColor ? ` style="border-left:3px solid ${chColor}"` : '';
 
-      return `<button class="ch-item${sel}" data-hash="${ch.hash}"${borderStyle} type="button" role="option" aria-selected="${selectedHash === ch.hash ? 'true' : 'false'}" aria-label="${escapeHtml(name)}">
+      return `<button class="ch-item${sel}" data-hash="${ch.hash}" type="button" role="option" aria-selected="${selectedHash === ch.hash ? 'true' : 'false'}" aria-label="${escapeHtml(name)}">
         <div class="ch-badge" style="background:${color}" aria-hidden="true">${escapeHtml(abbr)}</div>
         <div class="ch-item-body">
           <div class="ch-item-top">
             <span class="ch-item-name">${escapeHtml(name)}</span>
-            <span class="ch-color-dot" data-channel="${escapeHtml(ch.hash)}"${dotStyle} title="Change channel color" aria-label="Change color for ${escapeHtml(name)}"></span>
             <span class="ch-item-time" data-channel-hash="${ch.hash}">${time}</span>
           </div>
           <div class="ch-item-preview">${escapeHtml(preview)}</div>

public/customize-v2.js

@@ -33,10 +33,9 @@
     'meshcore-live-heatmap-opacity'
   ];
 
-  var VALID_SECTIONS = ['branding', 'theme', 'themeDark', 'nodeColors', 'typeColors', 'home', 'timestamps', 'heatmapOpacity', 'liveHeatmapOpacity', 'distanceUnit'];
+  var VALID_SECTIONS = ['branding', 'theme', 'themeDark', 'nodeColors', 'typeColors', 'home', 'timestamps', 'heatmapOpacity', 'liveHeatmapOpacity'];
   var OBJECT_SECTIONS = ['branding', 'theme', 'themeDark', 'nodeColors', 'typeColors', 'home', 'timestamps'];
   var SCALAR_SECTIONS = ['heatmapOpacity', 'liveHeatmapOpacity'];
-  var DISTANCE_UNIT_VALUES = ['km', 'mi', 'auto'];
 
   // CSS variable mapping (theme key → CSS custom property)
   var THEME_CSS_MAP = {
@@ -504,11 +503,6 @@
       localStorage.setItem('meshcore-live-heatmap-opacity', effectiveConfig.liveHeatmapOpacity);
     }
 
-    // Distance unit → sync to localStorage for all pages
-    if (typeof effectiveConfig.distanceUnit === 'string' && DISTANCE_UNIT_VALUES.indexOf(effectiveConfig.distanceUnit) >= 0) {
-      localStorage.setItem('meshcore-distance-unit', effectiveConfig.distanceUnit);
-    }
-
     // Nav gradient
     if (themeSection.navBg) {
       var nav = document.querySelector('.top-nav');
@@ -750,10 +744,6 @@
           }
         }
       }
-      // Validate distanceUnit
-      if (key === 'distanceUnit' && DISTANCE_UNIT_VALUES.indexOf(obj[key]) === -1) {
-        errors.push('Invalid distanceUnit: "' + obj[key] + '" — must be km, mi, or auto');
-      }
     }
     return { valid: errors.length === 0, errors: errors };
   }
@@ -905,7 +895,7 @@
       { id: 'theme', label: '🎨', title: 'Theme', badge: _tabBadge(isDarkMode() ? 'themeDark' : 'theme') },
       { id: 'nodes', label: '🎯', title: 'Colors', badge: (function () { var n = _countOverrides('nodeColors') + _countOverrides('typeColors'); return n ? ' <span class="cv2-tab-badge">' + n + '</span>' : ''; })() },
       { id: 'home', label: '🏠', title: 'Home', badge: _tabBadge('home') },
-      { id: 'display', label: '🖥️', title: 'Display', badge: (function () { var n = _countOverrides('timestamps') + (_isOverridden(null, 'distanceUnit') ? 1 : 0); return n ? ' <span class="cv2-tab-badge">' + n + '</span>' : ''; })() },
+      { id: 'display', label: '🖥️', title: 'Display', badge: _tabBadge('timestamps') },
       { id: 'export', label: '📤', title: 'Export' }
     ];
     return '<div class="cust-tabs">' + tabs.map(function (t) {
@@ -1069,7 +1059,6 @@
 
   function _renderDisplay() {
     var eff = _getEffective();
-    var distUnit = typeof eff.distanceUnit === 'string' && DISTANCE_UNIT_VALUES.indexOf(eff.distanceUnit) >= 0 ? eff.distanceUnit : 'auto';
     var ts = (eff.timestamps) || {};
     var tsMode = ts.defaultMode === 'absolute' ? 'absolute' : 'ago';
     var tsTz = ts.timezone === 'utc' ? 'utc' : 'local';
@@ -1097,13 +1086,6 @@
           '<option value="locale"' + (tsFmt === 'locale' ? ' selected' : '') + '>Locale (browser)</option></select></div>' +
       (canCustom ? '<div class="cust-field" data-ts-abs="custom"' + showAbs + '><label>Custom Format' + _overrideDot('timestamps', 'customFormat') + '</label>' +
         '<input type="text" data-cv2-field="timestamps.customFormat" value="' + escAttr(customFmt) + '" placeholder="YYYY-MM-DD HH:mm:ss"></div>' : '') +
-      '<p class="cust-section-title" style="font-size:14px;margin:16px 0 8px">Distances</p>' +
-      '<div class="cust-field"><label>Distance Unit' + _overrideDot(null, 'distanceUnit') + '</label>' +
-        '<select data-cv2-select="distanceUnit" style="width:100%;padding:6px 8px;border:1px solid var(--border);border-radius:6px;background:var(--input-bg);color:var(--text)">' +
-          '<option value="auto"' + (distUnit === 'auto' ? ' selected' : '') + '>Auto (browser locale)</option>' +
-          '<option value="km"' + (distUnit === 'km' ? ' selected' : '') + '>Kilometers (km)</option>' +
-          '<option value="mi"' + (distUnit === 'mi' ? ' selected' : '') + '>Miles (mi)</option>' +
-        '</select></div>' +
     '</div>';
   }
 
@@ -1342,16 +1324,12 @@
     container.querySelectorAll('[data-cv2-select]').forEach(function (sel) {
       sel.addEventListener('change', function () {
         var parts = sel.dataset.cv2Select.split('.');
-        if (parts.length === 1) {
-          setOverride(null, parts[0], sel.value);
-        } else {
-          setOverride(parts[0], parts[1], sel.value);
-          // Show/hide absolute-only fields
-          if (parts[1] === 'defaultMode') {
-            container.querySelectorAll('[data-ts-abs]').forEach(function (el) {
-              el.style.display = sel.value === 'absolute' ? '' : 'none';
-            });
-          }
+        setOverride(parts[0], parts[1], sel.value);
+        // Show/hide absolute-only fields
+        if (parts[1] === 'defaultMode') {
+          container.querySelectorAll('[data-ts-abs]').forEach(function (el) {
+            el.style.display = sel.value === 'absolute' ? '' : 'none';
+          });
         }
         window.dispatchEvent(new CustomEvent('timestamp-mode-changed'));
       });

public/index.html

@@ -92,16 +92,13 @@
   <script src="hop-display.js?v=__BUST__"></script>
   <script src="app.js?v=__BUST__"></script>
   <script src="home.js?v=__BUST__"></script>
-  <script src="table-sort.js?v=__BUST__"></script>
   <script src="packet-filter.js?v=__BUST__"></script>
   <script src="packet-helpers.js?v=__BUST__"></script>
   <script src="channel-colors.js?v=__BUST__"></script>
-  <script src="channel-color-picker.js?v=__BUST__"></script>
   <script src="packets.js?v=__BUST__"></script>
   <script src="geo-filter-overlay.js?v=__BUST__"></script>
   <script src="map.js?v=__BUST__" onerror="console.error('Failed to load:', this.src)"></script>
   <script src="channels.js?v=__BUST__" onerror="console.error('Failed to load:', this.src)"></script>
-  <script src="table-sort.js?v=__BUST__"></script>
   <script src="nodes.js?v=__BUST__" onerror="console.error('Failed to load:', this.src)"></script>
   <script src="traces.js?v=__BUST__" onerror="console.error('Failed to load:', this.src)"></script>
   <script src="analytics.js?v=__BUST__" onerror="console.error('Failed to load:', this.src)"></script>

public/live.css

@@ -19,36 +19,6 @@
   position: absolute;
   z-index: 1000;
   pointer-events: auto;
-  display: flex;
-  flex-direction: column;
-}
-
-/* ---- Panel header (non-scrolling) ---- */
-.panel-header {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  flex-shrink: 0;
-  padding: 4px 6px;
-}
-
-/* ---- Panel content (scrollable) ---- */
-.panel-content {
-  flex: 1;
-  overflow-y: auto;
-  min-height: 0;
-}
-
-.live-feed .panel-content {
-  display: flex;
-  flex-direction: column;
-  gap: 1px;
-}
-
-.live-legend .panel-content {
-  display: flex;
-  flex-direction: column;
-  gap: 3px;
 }
 
 /* ---- Header / Stats ---- */
@@ -136,6 +106,7 @@
   right: 12px;
   width: 320px;
   max-height: calc(100vh - 140px);
+  overflow-y: auto;
   background: color-mix(in srgb, var(--surface-1) 95%, transparent);
   backdrop-filter: blur(12px);
   border-radius: 10px;
@@ -155,12 +126,16 @@
   left: 12px;
   width: 360px;
   max-height: 340px;
+  overflow-y: auto;
   background: color-mix(in srgb, var(--surface-1) 92%, transparent);
   backdrop-filter: blur(12px);
   border-radius: 10px;
   border: 1px solid var(--border);
   box-shadow: 0 4px 24px rgba(0, 0, 0, 0.5);
   padding: 6px;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
 }
 
 .live-feed-item {
@@ -223,6 +198,9 @@
   box-shadow: 0 4px 24px rgba(0, 0, 0, 0.5);
   color: var(--text-muted);
   font-size: 11px;
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
   transition: opacity 0.3s, transform 0.3s;
 }
 
@@ -800,52 +778,3 @@
 }
 .nav-pin-btn:hover { opacity: 0.8; }
 .nav-pin-btn.pinned { opacity: 1; filter: drop-shadow(0 0 4px rgba(59,130,246,0.5)); }
-
-/* ========== Panel Corner Positioning (#608 M0) ========== */
-/* Corner positions — applied via data-position attribute on .live-overlay panels */
-.live-overlay[data-position="tl"] { top: 64px; left: 12px; bottom: auto; right: auto; }
-.live-overlay[data-position="tr"] { top: 64px; right: 12px; bottom: auto; left: auto; }
-.live-overlay[data-position="bl"] { bottom: 12px; left: 12px; top: auto; right: auto; }
-.live-overlay[data-position="br"] { bottom: 12px; right: 12px; top: auto; left: auto; }
-
-/* Override hide animations for positioned panels — slide toward nearest edge */
-.live-overlay[data-position="tl"].hidden,
-.live-overlay[data-position="bl"].hidden { transform: translateX(-100%); }
-.live-overlay[data-position="tr"].hidden,
-.live-overlay[data-position="br"].hidden { transform: translateX(100%); }
-.live-overlay[data-position].hidden { opacity: 0; pointer-events: none; visibility: hidden; }
-
-/* Corner toggle button */
-.panel-corner-btn {
-  width: 28px;
-  height: 28px;
-  padding: 0;
-  border: none;
-  background: transparent;
-  color: var(--text-muted);
-  cursor: pointer;
-  opacity: 0.6;
-  transition: opacity 0.15s, background 0.15s;
-  font-size: 14px;
-  line-height: 28px;
-  text-align: center;
-  flex-shrink: 0;
-  border-radius: 4px;
-}
-.panel-corner-btn:hover { opacity: 1; background: color-mix(in srgb, var(--text) 12%, transparent); }
-.panel-corner-btn:focus-visible {
-  opacity: 1;
-  outline: 2px solid var(--accent);
-  outline-offset: 2px;
-  border-radius: 3px;
-}
-
-/* On mobile, corner toggle is not useful (panels are hidden or bottom-sheet) */
-@media (max-width: 640px) {
-  .panel-corner-btn { display: none !important; }
-  .live-overlay[data-position] {
-    top: unset !important; bottom: unset !important;
-    left: unset !important; right: unset !important;
-  }
-}
-

public/live.js

@@ -58,92 +58,6 @@
     REQUEST: '❓', RESPONSE: '📨', TRACE: '🔍', PATH: '🛤️'
   };
 
-  /* ---- Panel Corner Positioning (#608 M0) ---- */
-  var PANEL_DEFAULTS = { liveFeed: 'bl', liveLegend: 'br', liveNodeDetail: 'tr' };
-  var CORNER_CYCLE = ['tl', 'tr', 'br', 'bl'];
-  var CORNER_ARROWS = { tl: '↘', tr: '↙', bl: '↗', br: '↖' };
-  var CORNER_LABELS = { tl: 'top-left', tr: 'top-right', bl: 'bottom-left', br: 'bottom-right' };
-  var PANEL_NAMES = { liveFeed: 'Feed', liveLegend: 'Legend', liveNodeDetail: 'Node detail' };
-
-  function getPanelPositions() {
-    var pos = {};
-    for (var id in PANEL_DEFAULTS) {
-      try { pos[id] = localStorage.getItem('panel-corner-' + id) || PANEL_DEFAULTS[id]; }
-      catch (_) { pos[id] = PANEL_DEFAULTS[id]; }
-    }
-    return pos;
-  }
-
-  function nextAvailableCorner(panelId, desired, allPositions) {
-    var idx = CORNER_CYCLE.indexOf(desired);
-    for (var i = 0; i < 4; i++) {
-      var candidate = CORNER_CYCLE[(idx + i) % 4];
-      var occupied = false;
-      for (var otherId in allPositions) {
-        if (otherId !== panelId && allPositions[otherId] === candidate) { occupied = true; break; }
-      }
-      if (!occupied) return candidate;
-    }
-    return desired; // all occupied (impossible with 3 panels, 4 corners)
-  }
-
-  function applyPanelPosition(id, corner) {
-    var el = document.getElementById(id);
-    if (!el) return;
-    el.setAttribute('data-position', corner);
-    var btn = el.querySelector('.panel-corner-btn');
-    if (btn) {
-      btn.textContent = CORNER_ARROWS[corner];
-      btn.setAttribute('aria-label',
-        'Move ' + (PANEL_NAMES[id] || 'panel') + ' to next corner (currently ' + CORNER_LABELS[corner] + ')');
-    }
-  }
-
-  function initPanelPositions() {
-    var positions = getPanelPositions();
-    for (var id in positions) {
-      applyPanelPosition(id, positions[id]);
-    }
-    // Wire up click handlers on corner buttons
-    var btns = document.querySelectorAll('.panel-corner-btn[data-panel]');
-    for (var i = 0; i < btns.length; i++) {
-      btns[i].addEventListener('click', function(e) {
-        e.stopPropagation();
-        var panelId = this.getAttribute('data-panel');
-        onCornerClick(panelId);
-      });
-    }
-  }
-
-  function onCornerClick(panelId) {
-    var positions = getPanelPositions();
-    var current = positions[panelId];
-    var nextIdx = (CORNER_CYCLE.indexOf(current) + 1) % 4;
-    var next = nextAvailableCorner(panelId, CORNER_CYCLE[nextIdx], positions);
-    try { localStorage.setItem('panel-corner-' + panelId, next); } catch (_) { /* quota */ }
-    applyPanelPosition(panelId, next);
-    // Announce for screen readers
-    var announce = document.getElementById('panelPositionAnnounce');
-    if (announce) announce.textContent = (PANEL_NAMES[panelId] || 'Panel') + ' moved to ' + CORNER_LABELS[next];
-  }
-
-  function resetPanelPositions() {
-    for (var id in PANEL_DEFAULTS) {
-      try { localStorage.removeItem('panel-corner-' + id); } catch (_) { /* ignore */ }
-      applyPanelPosition(id, PANEL_DEFAULTS[id]);
-    }
-  }
-
-  // Export for testing
-  if (typeof window !== 'undefined') {
-    window._panelCorner = {
-      PANEL_DEFAULTS: PANEL_DEFAULTS, CORNER_CYCLE: CORNER_CYCLE,
-      getPanelPositions: getPanelPositions, nextAvailableCorner: nextAvailableCorner,
-      applyPanelPosition: applyPanelPosition, onCornerClick: onCornerClick,
-      resetPanelPositions: resetPanelPositions
-    };
-  }
-
   function formatLiveTimestampHtml(isoLike) {
     if (typeof formatTimestampWithTooltip !== 'function' || typeof getTimestampMode !== 'function') {
       return escapeHtml(typeof timeAgo === 'function' ? timeAgo(isoLike) : '—');
@@ -841,26 +755,15 @@
           </div>
         </div>
         <div class="live-overlay live-feed" id="liveFeed">
-          <div class="panel-header">
-            <button class="panel-corner-btn" data-panel="liveFeed" title="Move panel to next corner" aria-label="Move panel to next corner">◫</button>
-            <button class="feed-hide-btn" id="feedHideBtn" title="Hide feed">✕</button>
-          </div>
-          <div class="panel-content" aria-live="polite" aria-relevant="additions" role="log"></div>
+          <button class="feed-hide-btn" id="feedHideBtn" title="Hide feed">✕</button>
         </div>
         <button class="feed-show-btn hidden" id="feedShowBtn" title="Show feed">📋</button>
         <div class="live-overlay live-node-detail hidden" id="liveNodeDetail">
-          <div class="panel-header">
-            <button class="panel-corner-btn" data-panel="liveNodeDetail" title="Move panel to next corner" aria-label="Move panel to next corner">◫</button>
-            <button class="feed-hide-btn" id="nodeDetailClose" title="Close">✕</button>
-          </div>
-          <div class="panel-content" id="nodeDetailContent"></div>
+          <button class="feed-hide-btn" id="nodeDetailClose" title="Close">✕</button>
+          <div id="nodeDetailContent"></div>
         </div>
         <button class="legend-toggle-btn" id="legendToggleBtn" aria-label="Show legend" title="Show legend">🎨</button>
         <div class="live-overlay live-legend" id="liveLegend" role="region" aria-label="Map legend">
-          <div class="panel-header">
-            <button class="panel-corner-btn" data-panel="liveLegend" title="Move panel to next corner" aria-label="Move panel to next corner">◫</button>
-          </div>
-          <div class="panel-content">
           <h3 class="legend-title">PACKET TYPES</h3>
           <ul class="legend-list">
             <li><span class="live-dot" style="background:${TYPE_COLORS.ADVERT}" aria-hidden="true"></span> Advert — Node advertisement</li>
@@ -871,11 +774,9 @@
           </ul>
           <h3 class="legend-title" style="margin-top:8px">NODE ROLES</h3>
           <ul class="legend-list" id="roleLegendList"></ul>
-          </div>
         </div>
 
         <!-- VCR Bar -->
-        <div class="sr-only" id="panelPositionAnnounce" aria-live="polite"></div>
         <div class="vcr-bar" id="vcrBar">
           <div class="vcr-controls">
             <button id="vcrRewindBtn" class="vcr-btn" title="Rewind" aria-label="Rewind">⏪</button>
@@ -1159,8 +1060,6 @@
     }
 
     // Populate role legend from shared roles.js
-    // Initialize panel corner positions (#608 M0)
-    initPanelPositions();
     const roleLegendList = document.getElementById('roleLegendList');
     if (roleLegendList) {
       for (const role of (window.ROLE_SORT || ['repeater', 'companion', 'room', 'sensor', 'observer'])) {
@@ -1424,7 +1323,7 @@
       let html = `
         <div style="padding:16px;">
           <div style="display:flex;align-items:center;gap:8px;margin-bottom:12px;">
-            <span class="${statusDot}" style="font-size:18px" aria-hidden="true">●</span>
+            <span class="${statusDot}" style="font-size:18px">●</span>
             <h3 style="margin:0;font-size:16px;font-weight:700;">${escapeHtml(n.name || 'Unknown')}</h3>
           </div>
           <div style="margin-bottom:12px;">
@@ -1603,9 +1502,7 @@
   function rebuildFeedList() {
     const feed = document.getElementById('liveFeed');
     if (!feed) return;
-    const feedContent = feed.querySelector('.panel-content');
-    if (!feedContent) return;
-    feedContent.querySelectorAll('.live-feed-item').forEach(el => el.remove());
+    feed.querySelectorAll('.live-feed-item').forEach(el => el.remove());
     feedDedup.clear();
 
     // Aggregate VCR buffer by hash, then create one feed item per unique hash
@@ -1653,10 +1550,6 @@
       const hopStr = longestHops.length ? `<span class="feed-hops">${longestHops.length}⇢</span>` : '';
       const obsBadge = group.count > 1 ? `<span class="badge badge-obs" style="font-size:10px;margin-left:4px">👁 ${group.count}</span>` : '';
 
-      var _ccPayload = (pkt.decoded || {}).payload || {};
-      var _ccChan1 = (typeName === 'GRP_TXT' || typeName === 'CHAN') ? (_ccPayload.channel || null) : null;
-      var dotHtml1 = _ccChan1 ? _feedColorDot(_ccChan1) : '';
-
       const item = document.createElement('div');
       item.className = 'live-feed-item';
       item.setAttribute('tabindex', '0');
@@ -1666,13 +1559,12 @@
       item.innerHTML = `
         <span class="feed-icon" style="color:${color}">${icon}</span>
         <span class="feed-type" style="color:${color}">${typeName}</span>
-        ${dotHtml1}${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
+        ${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
         <span class="feed-text">${escapeHtml(preview)}</span>
         <span class="feed-time">${formatLiveTimestampHtml(group.latestTs || Date.now())}</span>
       `;
-      if (_ccChan1) item._ccChannel = _ccChan1; // channel color picker (#674)
       item.addEventListener('click', () => showFeedCard(item, pkt, color));
-      feedContent.appendChild(item);
+      feed.appendChild(item);
 
       // Register in dedup map so replay and live updates work
       if (group.hash) {
@@ -2006,66 +1898,11 @@
         }
       }
       firstPathDone = true;
-      // For TRACE packets, split at hopsCompleted: solid for completed, dashed for remaining
-      var hopsCompleted = decoded.path && decoded.path.hopsCompleted;
-      if (typeName === 'TRACE' && hopsCompleted != null && hopsCompleted < allPaths[ai].hopPositions.length) {
-        var completedPositions = allPaths[ai].hopPositions.slice(0, hopsCompleted + 1);
-        var remainingPositions = allPaths[ai].hopPositions.slice(hopsCompleted);
-        if (completedPositions.length >= 2) {
-          animatePath(completedPositions, typeName, color, allPaths[ai].raw, onHop);
-        } else if (completedPositions.length === 1) {
-          pulseNode(completedPositions[0].key, completedPositions[0].pos, typeName);
-        }
-        if (remainingPositions.length >= 2) {
-          drawDashedPath(remainingPositions, color);
-        }
-      } else {
-        animatePath(allPaths[ai].hopPositions, typeName, color, allPaths[ai].raw, onHop);
-      }
-    }
-  }
-
-  // Draw a static dashed/ghosted line for unreached TRACE hops
-  function drawDashedPath(hopPositions, color) {
-    var GHOST_TIMEOUT_MS = 10000;
-    var ghostColor = getComputedStyle(document.documentElement).getPropertyValue('--trace-ghost-color').trim() || '#94a3b8';
-    if (!pathsLayer) return;
-    for (var i = 0; i < hopPositions.length - 1; i++) {
-      var from = hopPositions[i].pos;
-      var to = hopPositions[i + 1].pos;
-      var line = L.polyline([from, to], {
-        color: color, weight: 2, opacity: 0.25, dashArray: '6, 8'
-      }).addTo(pathsLayer);
-      // Pulse the unreached hop nodes as ghost markers
-      if (i > 0) {
-        var hp = hopPositions[i];
-        if (!nodeMarkers[hp.key]) {
-          var ghost = L.circleMarker(hp.pos, {
-            radius: 3, fillColor: ghostColor, fillOpacity: 0.2, color: color, weight: 1, opacity: 0.3
-          }).addTo(pathsLayer);
-          setTimeout((function(g) { return function() { if (pathsLayer.hasLayer(g)) pathsLayer.removeLayer(g); }; })(ghost), GHOST_TIMEOUT_MS);
-        }
-      }
-      // Remove dashed line after timeout
-      setTimeout((function(l) { return function() { if (pathsLayer.hasLayer(l)) pathsLayer.removeLayer(l); }; })(line), GHOST_TIMEOUT_MS);
-    }
-    // Ghost marker for the final unreached hop
-    var last = hopPositions[hopPositions.length - 1];
-    if (!nodeMarkers[last.key]) {
-      var ghostEnd = L.circleMarker(last.pos, {
-        radius: 4, fillColor: ghostColor, fillOpacity: 0.25, color: color, weight: 1, opacity: 0.35
-      }).addTo(pathsLayer);
-      setTimeout(function() { if (pathsLayer.hasLayer(ghostEnd)) pathsLayer.removeLayer(ghostEnd); }, GHOST_TIMEOUT_MS);
+      animatePath(allPaths[ai].hopPositions, typeName, color, allPaths[ai].raw, onHop);
     }
   }
 
   function resolveHopPositions(hops, payload, resolvedPath) {
-    // Hoist sender GPS guard once — reject (0,0) as "no GPS"
-    const hasValidGps = payload.lat != null && payload.lon != null
-      && !(payload.lat === 0 && payload.lon === 0);
-    const senderLat = hasValidGps ? payload.lat : null;
-    const senderLon = hasValidGps ? payload.lon : null;
-
     // Prefer server-side resolved_path when available
     var resolvedMap;
     if (resolvedPath && resolvedPath.length === hops.length && window.HopResolver && HopResolver.ready()) {
@@ -2073,14 +1910,19 @@
       // Fill in any null entries from client-side fallback, preserving sender GPS context
       var nullHops = hops.filter(function(h, i) { return !resolvedPath[i] && !resolvedMap[h]; });
       if (nullHops.length) {
-        var fallback = HopResolver.resolve(nullHops, senderLat, senderLon, null, null, null);
+        const originLat = payload.lat != null && !(payload.lat === 0 && payload.lon === 0) ? payload.lat : null;
+        const originLon = payload.lon != null && !(payload.lon === 0 && payload.lon === 0) ? payload.lon : null;
+        var fallback = HopResolver.resolve(nullHops, originLat, originLon, null, null, null);
         for (var k in fallback) resolvedMap[k] = fallback[k];
       }
     } else {
       // Delegate to shared HopResolver (from hop-resolver.js) instead of reimplementing
+      const originLat = payload.lat != null && !(payload.lat === 0 && payload.lon === 0) ? payload.lat : null;
+      const originLon = payload.lon != null && !(payload.lon === 0 && payload.lon === 0) ? payload.lon : null;
+
       // Use HopResolver if available and initialized, otherwise fall back to simple lookup
       resolvedMap = (window.HopResolver && HopResolver.ready())
-        ? HopResolver.resolve(hops, senderLat, senderLon, null, null, null)
+        ? HopResolver.resolve(hops, originLat, originLon, null, null, null)
         : {};
     }
 
@@ -2099,7 +1941,7 @@
     });
 
     // Add sender position as anchor if available
-    if (payload.pubKey && senderLat != null) {
+    if (payload.pubKey && originLat != null) {
       const existing = raw.find(p => p.key === payload.pubKey);
       if (!existing) {
         raw.unshift({ key: payload.pubKey, pos: [payload.lat, payload.lon], name: payload.name || payload.pubKey.slice(0, 8), known: true });
@@ -2657,22 +2499,9 @@
   function _getChannelStyle(pkt) {
     if (!window.ChannelColors) return '';
     var d = pkt.decoded || {};
+    var h = d.header || {};
     var p = d.payload || {};
-    var typeName = p.type || (d.header || {}).payloadTypeName || '';
-    var ch = p.channel || null;
-    return window.ChannelColors.getRowStyle(typeName, ch);
-  }
-
-  /** Build a clickable 12×12 color dot for a channel feed item (#674). */
-  function _feedColorDot(channel) {
-    if (!channel || !window.ChannelColors) return '';
-    var c = window.ChannelColors.get(channel);
-    var bg = c || 'transparent';
-    var border = c ? c : 'var(--border-color, #555)';
-    var style = c
-      ? 'background:' + bg + ';border:1px solid ' + border
-      : 'background:transparent;border:1px dashed ' + border;
-    return '<span class="feed-color-dot" data-channel="' + escapeHtml(channel) + '" style="display:inline-block;width:12px;height:12px;border-radius:50%;' + style + ';cursor:pointer;vertical-align:middle;margin-left:4px;flex-shrink:0" title="Set color for ' + escapeHtml(channel) + '"></span>';
+    return window.ChannelColors.getRowStyle(h.payloadTypeName || '', p.channelName || null);
   }
 
   function addFeedItemDOM(icon, typeName, payload, hops, color, pkt, feed) {
@@ -2680,9 +2509,6 @@
     const preview = text ? ' ' + (text.length > 35 ? text.slice(0, 35) + '…' : text) : '';
     const hopStr = hops.length ? `<span class="feed-hops">${hops.length}⇢</span>` : '';
     const obsBadge = pkt.observation_count > 1 ? `<span class="badge badge-obs" style="font-size:10px;margin-left:4px">👁 ${pkt.observation_count}</span>` : '';
-    var _ccPayload2 = (pkt.decoded || {}).payload || {};
-    var _ccChan = (typeName === 'GRP_TXT' || typeName === 'CHAN') ? (_ccPayload2.channel || null) : null;
-    var dotHtml = _ccChan ? _feedColorDot(_ccChan) : '';
     const item = document.createElement('div');
     item.className = 'live-feed-item';
     item.setAttribute('tabindex', '0');
@@ -2694,11 +2520,10 @@
     item.innerHTML = `
       <span class="feed-icon" style="color:${color}">${icon}</span>
       <span class="feed-type" style="color:${color}">${typeName}</span>
-      ${dotHtml}${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
+      ${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
       <span class="feed-text">${escapeHtml(preview)}</span>
       <span class="feed-time">${formatLiveTimestampHtml(pkt._ts || Date.now())}</span>
     `;
-    if (_ccChan) item._ccChannel = _ccChan; // channel color picker (#674)
     item.addEventListener('click', () => showFeedCard(item, pkt, color));
     feed.appendChild(item);
   }
@@ -2711,8 +2536,7 @@
   const DEDUP_WINDOW = 30000;
 
   function addFeedItem(icon, typeName, payload, hops, color, pkt) {
-    const feedPanel = document.getElementById('liveFeed');
-    const feed = feedPanel ? feedPanel.querySelector('.panel-content') : null;
+    const feed = document.getElementById('liveFeed');
     if (!feed) return;
     if (showOnlyFavorites && !packetInvolvesFavorite(pkt)) return;
 
@@ -2754,9 +2578,6 @@
     const preview = text ? ' ' + (text.length > 35 ? text.slice(0, 35) + '…' : text) : '';
     const hopStr = hops.length ? `<span class="feed-hops">${hops.length}⇢</span>` : '';
     const obsBadge = incomingObs > 1 ? `<span class="badge badge-obs" style="font-size:10px;margin-left:4px">👁 ${incomingObs}</span>` : '';
-    var _ccPayload3 = (pkt.decoded || {}).payload || {};
-    var _ccChan3 = (typeName === 'GRP_TXT' || typeName === 'CHAN') ? (_ccPayload3.channel || null) : null;
-    var dotHtml3 = _ccChan3 ? _feedColorDot(_ccChan3) : '';
 
     const item = document.createElement('div');
     item.className = 'live-feed-item live-feed-enter';
@@ -2770,11 +2591,10 @@
     item.innerHTML = `
       <span class="feed-icon" style="color:${color}">${icon}</span>
       <span class="feed-type" style="color:${color}">${typeName}</span>
-      ${dotHtml3}${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
+      ${transportBadge(pkt.route_type)}${hopStr}${obsBadge}
       <span class="feed-text">${escapeHtml(preview)}</span>
       <span class="feed-time">${formatLiveTimestampHtml(pkt._ts || Date.now())}</span>
     `;
-    if (_ccChan3) item._ccChannel = _ccChan3; // channel color picker (#674)
     item.addEventListener('click', () => showFeedCard(item, pkt, color));
     feed.prepend(item);
     requestAnimationFrame(() => requestAnimationFrame(() => item.classList.remove('live-feed-enter')));
@@ -2894,10 +2714,7 @@
         if (activeNodeDetailKey) showNodeDetail(activeNodeDetailKey);
       };
       window.addEventListener('theme-refresh', _themeRefreshHandler);
-      var result = init(app, routeParam);
-      // Install channel color picker (M2, #271)
-      if (window.ChannelColorPicker) window.ChannelColorPicker.installLiveFeed();
-      return result;
+      return init(app, routeParam);
     },
     destroy: function() {
       if (_themeRefreshHandler) { window.removeEventListener('theme-refresh', _themeRefreshHandler); _themeRefreshHandler = null; }

public/nodes.js

@@ -20,24 +20,26 @@
   let activeTab = 'all';
   let search = '';
   // Sort state: column + direction, persisted to localStorage
-  // Managed by TableSort utility (public/table-sort.js) when DOM is available,
-  // falls back to simple object for unit testing
-  var _nodesTableSortCtrl = null;
-  // TODO(M5): remove fallback when tests use DOM sandbox
-  var _fallbackSortState = null; // used when TableSort controller not initialized (tests)
-
-  function _getSortState() {
-    if (_nodesTableSortCtrl) return _nodesTableSortCtrl.getState();
-    if (_fallbackSortState) return _fallbackSortState;
+  let sortState = (function () {
     try {
-      var saved = JSON.parse(localStorage.getItem('meshcore-nodes-sort'));
+      const saved = JSON.parse(localStorage.getItem('meshcore-nodes-sort'));
       if (saved && saved.column && saved.direction) return saved;
-    } catch (e) { /* ignore */ }
+    } catch {}
     return { column: 'last_seen', direction: 'desc' };
+  })();
+
+  function toggleSort(column) {
+    if (sortState.column === column) {
+      sortState.direction = sortState.direction === 'asc' ? 'desc' : 'asc';
+    } else {
+      // Default direction per column type
+      const descDefault = ['last_seen', 'advert_count'];
+      sortState = { column, direction: descDefault.includes(column) ? 'desc' : 'asc' };
+    }
+    localStorage.setItem('meshcore-nodes-sort', JSON.stringify(sortState));
   }
 
   function sortNodes(arr) {
-    var sortState = _getSortState();
     const col = sortState.column;
     const dir = sortState.direction === 'asc' ? 1 : -1;
     return arr.sort(function (a, b) {
@@ -64,6 +66,11 @@
       return 0;
     });
   }
+
+  function sortArrow(col) {
+    if (sortState.column !== col) return '';
+    return '<span class="sort-arrow">' + (sortState.direction === 'asc' ? '▲' : '▼') + '</span>';
+  }
   let lastHeard = localStorage.getItem('meshcore-nodes-last-heard') || '';
   let statusFilter = localStorage.getItem('meshcore-nodes-status-filter') || 'all';
   let wsHandler = null;
@@ -78,18 +85,6 @@
     { key: 'sensor', label: 'Sensors' },
   ];
 
-  function buildNodesQuery(tab, searchStr) {
-    var parts = [];
-    if (tab && tab !== 'all') parts.push('tab=' + encodeURIComponent(tab));
-    if (searchStr) parts.push('search=' + encodeURIComponent(searchStr));
-    return parts.length ? '?' + parts.join('&') : '';
-  }
-  window.buildNodesQuery = buildNodesQuery;
-
-  function updateNodesUrl() {
-    history.replaceState(null, '', '#/nodes' + buildNodesQuery(activeTab, search));
-  }
-
   function renderNodeTimestampHtml(isoString) {
     if (typeof formatTimestampWithTooltip !== 'function' || typeof getTimestampMode !== 'function') {
       return escapeHtml(typeof timeAgo === 'function' ? timeAgo(isoString) : '—');
@@ -194,7 +189,7 @@
 
   function renderNeighborRows(neighbors, limit) {
     var sorted = neighbors.slice().sort(function(a, b) {
-      return (b.count || 0) - (a.count || 0);
+      return (b.score || b.affinity || 0) - (a.score || a.affinity || 0);
     });
     var items = limit ? sorted.slice(0, limit) : sorted;
     return items.map(function(nb) {
@@ -209,21 +204,15 @@
         : '<span class="text-muted">—</span>';
       var scoreTitle = 'Observations: ' + nb.count;
       if (nb.avg_snr != null) scoreTitle += ' · Avg SNR: ' + Number(nb.avg_snr).toFixed(1) + ' dB';
-      var distanceCell = nb.distance_km != null
-        ? formatDistance(Number(nb.distance_km))
-        : '<span class="text-muted">—</span>';
       var showOnMap = nb.pubkey
         ? ' <button class="btn-link neighbor-show-map" data-pubkey="' + escapeHtml(nb.pubkey) + '" style="font-size:11px;padding:1px 6px;white-space:nowrap">📍 Map</button>'
         : '';
-      var lastSeenVal = nb.last_seen ? new Date(nb.last_seen).getTime() : 0;
-      var distanceVal = nb.distance_km != null ? Number(nb.distance_km) : '';
       return '<tr>' +
-        '<td data-value="' + escapeHtml(name.toLowerCase()) + '" style="font-weight:600">' + nameHtml + '</td>' +
-        '<td data-value="' + escapeHtml(role.toLowerCase()) + '">' + roleBadge + '</td>' +
-        '<td data-value="' + Number(nb.score || 0) + '" title="' + escapeHtml(scoreTitle) + '">' + Number(nb.score).toFixed(2) + '</td>' +
-        '<td data-value="' + (nb.count || 0) + '">' + nb.count + '</td>' +
-        '<td data-value="' + lastSeenVal + '">' + renderNodeTimestampHtml(nb.last_seen) + '</td>' +
-        '<td data-value="' + distanceVal + '">' + distanceCell + '</td>' +
+        '<td style="font-weight:600">' + nameHtml + '</td>' +
+        '<td>' + roleBadge + '</td>' +
+        '<td title="' + escapeHtml(scoreTitle) + '">' + Number(nb.score).toFixed(2) + '</td>' +
+        '<td>' + nb.count + '</td>' +
+        '<td>' + renderNodeTimestampHtml(nb.last_seen) + '</td>' +
         '<td><span title="' + conf.label + '">' + conf.icon + '</span></td>' +
         '<td style="text-align:right">' + showOnMap + '</td>' +
         '</tr>';
@@ -231,16 +220,8 @@
   }
 
   function renderNeighborTable(neighbors, limit) {
-    return '<table class="data-table neighbor-sort-table" style="font-size:12px">' +
-      '<thead><tr>' +
-      '<th scope="col" data-sort-key="name">Neighbor</th>' +
-      '<th scope="col" data-sort-key="role">Role</th>' +
-      '<th scope="col" data-sort-key="score" data-type="numeric" data-sort-default="desc">Score</th>' +
-      '<th scope="col" data-sort-key="count" data-type="numeric" data-sort-default="desc">Obs</th>' +
-      '<th scope="col" data-sort-key="last_seen" data-type="numeric" data-sort-default="desc">Last Seen</th>' +
-      '<th scope="col" data-sort-key="distance" data-type="numeric">Distance</th>' +
-      '<th scope="col">Conf</th><th scope="col"></th>' +
-      '</tr></thead>' +
+    return '<table class="data-table" style="font-size:12px">' +
+      '<thead><tr><th>Neighbor</th><th>Role</th><th>Score</th><th>Obs</th><th>Last Seen</th><th>Conf</th><th></th></tr></thead>' +
       '<tbody>' + renderNeighborRows(neighbors, limit) + '</tbody></table>';
   }
 
@@ -291,15 +272,6 @@
     }
     el.innerHTML = html;
 
-    // Initialize TableSort on neighbor table
-    var neighborTable = el.querySelector('.neighbor-sort-table');
-    if (neighborTable && window.TableSort) {
-      TableSort.init(neighborTable, {
-        defaultColumn: 'count',
-        defaultDirection: 'desc'
-      });
-    }
-
     // Wire up "Show on Map" buttons via event delegation
     el.addEventListener('click', function(e) {
       var btn = e.target.closest('.neighbor-show-map');
@@ -341,15 +313,6 @@
       return;
     }
 
-    // Reset list-view state to defaults, then override from URL params
-    activeTab = 'all';
-    search = '';
-    const _listUrlParams = getHashParams();
-    const _urlTab = _listUrlParams.get('tab');
-    const _urlSearch = _listUrlParams.get('search');
-    if (_urlTab && TABS.some(function(t) { return t.key === _urlTab; })) activeTab = _urlTab;
-    if (_urlSearch) search = _urlSearch;
-
     app.innerHTML = `<div class="nodes-page">
       <div class="nodes-topbar">
         <input type="text" class="nodes-search" id="nodeSearch" placeholder="Search nodes by name…" aria-label="Search nodes by name">
@@ -357,7 +320,7 @@
       </div>
       <div id="nodesRegionFilter" class="region-filter-container"></div>
       <div class="split-layout">
-        <div class="panel-left" id="nodesLeft" aria-live="polite" aria-relevant="additions removals"></div>
+        <div class="panel-left" id="nodesLeft"></div>
         <div class="panel-right empty" id="nodesRight"><span>Select a node to view details</span></div>
       </div>
     </div>`;
@@ -365,14 +328,8 @@
     RegionFilter.init(document.getElementById('nodesRegionFilter'));
     regionChangeHandler = RegionFilter.onChange(function () { _allNodes = null; loadNodes(); });
 
-    if (search) {
-      var _si = document.getElementById('nodeSearch');
-      if (_si) _si.value = search;
-    }
-
     document.getElementById('nodeSearch').addEventListener('input', debounce(e => {
       search = e.target.value;
-      updateNodesUrl();
       loadNodes();
     }, 250));
 
@@ -496,21 +453,15 @@
         ${observers.length ? `<div class="node-full-card" id="node-observers">
           ${(() => { const regions = [...new Set(observers.map(o => o.iata).filter(Boolean))]; return regions.length ? `<div style="margin-bottom:8px"><strong>Regions:</strong> ${regions.map(r => '<span class="badge" style="margin:0 2px">' + escapeHtml(r) + '</span>').join(' ')}</div>` : ''; })()}
           <h4>Heard By (${observers.length} observer${observers.length > 1 ? 's' : ''})</h4>
-          <table class="data-table observer-sort-table" style="font-size:12px">
-            <thead><tr>
-              <th scope="col" data-sort-key="observer">Observer</th>
-              <th scope="col" data-sort-key="region">Region</th>
-              <th scope="col" data-sort-key="packets" data-type="numeric" data-sort-default="desc">Packets</th>
-              <th scope="col" data-sort-key="snr" data-type="numeric" data-sort-default="desc">Avg SNR</th>
-              <th scope="col" data-sort-key="rssi" data-type="numeric" data-sort-default="desc">Avg RSSI</th>
-            </tr></thead>
+          <table class="data-table" style="font-size:12px">
+            <thead><tr><th scope="col">Observer</th><th scope="col">Region</th><th scope="col">Packets</th><th scope="col">Avg SNR</th><th scope="col">Avg RSSI</th></tr></thead>
             <tbody>
               ${observers.map(o => `<tr>
-                <td data-value="${escapeHtml((o.observer_name || o.observer_id || '').toLowerCase())}" style="font-weight:600">${escapeHtml(o.observer_name || o.observer_id)}</td>
-                <td data-value="${escapeHtml((o.iata || '').toLowerCase())}">${o.iata ? escapeHtml(o.iata) : '—'}</td>
-                <td data-value="${o.packetCount || 0}">${o.packetCount}</td>
-                <td data-value="${o.avgSnr != null ? Number(o.avgSnr) : ''}">${o.avgSnr != null ? Number(o.avgSnr).toFixed(1) + ' dB' : '—'}</td>
-                <td data-value="${o.avgRssi != null ? Number(o.avgRssi) : ''}">${o.avgRssi != null ? Number(o.avgRssi).toFixed(0) + ' dBm' : '—'}</td>
+                <td style="font-weight:600">${escapeHtml(o.observer_name || o.observer_id)}</td>
+                <td>${o.iata ? escapeHtml(o.iata) : '—'}</td>
+                <td>${o.packetCount}</td>
+                <td>${o.avgSnr != null ? Number(o.avgSnr).toFixed(1) + ' dB' : '—'}</td>
+                <td>${o.avgRssi != null ? Number(o.avgRssi).toFixed(0) + ' dBm' : '—'}</td>
               </tr>`).join('')}
             </tbody>
           </table>
@@ -548,12 +499,10 @@
               let hashSizeBadge = '';
               if (n.hash_size_inconsistent && p.payload_type === 4 && p.raw_hex) {
                 const pb = parseInt(p.raw_hex.slice(2, 4), 16);
-                if ((pb & 0x3F) !== 0) {
-                  const hs = ((pb >> 6) & 0x3) + 1;
-                  const hsColor = hs >= 3 ? '#16a34a' : hs === 2 ? '#86efac' : '#f97316';
-                  const hsFg = hs === 2 ? '#064e3b' : '#fff';
-                  hashSizeBadge = ` <span class="badge" style="background:${hsColor};color:${hsFg};font-size:9px;font-family:var(--mono)">${hs}B</span>`;
-                }
+                const hs = ((pb >> 6) & 0x3) + 1;
+                const hsColor = hs >= 3 ? '#16a34a' : hs === 2 ? '#86efac' : '#f97316';
+                const hsFg = hs === 2 ? '#064e3b' : '#fff';
+                hashSizeBadge = ` <span class="badge" style="background:${hsColor};color:${hsFg};font-size:9px;font-family:var(--mono)">${hs}B</span>`;
               }
               return `<div class="node-activity-item">
                 <span class="node-activity-time">${renderNodeTimestampHtml(p.timestamp)}</span>
@@ -610,15 +559,6 @@
         } catch {}
       }
 
-      // Initialize TableSort on observer table (full detail page)
-      var observerTable = document.querySelector('#node-observers .observer-sort-table');
-      if (observerTable && window.TableSort) {
-        TableSort.init(observerTable, {
-          defaultColumn: 'packets',
-          defaultDirection: 'desc'
-        });
-      }
-
       // Fetch neighbors for this node (full-screen view)
       fetchAndRenderNeighbors(n.public_key, 'fullNeighborsContent', {
         headerSelector: '#fullNeighborsHeader'
@@ -915,11 +855,11 @@
       </div>
       <table class="data-table" id="nodesTable">
         <thead><tr>
-          <th scope="col" data-sort-key="name">Name</th>
-          <th scope="col" class="col-pubkey" data-sort-key="public_key">Public Key</th>
-          <th scope="col" data-sort-key="role">Role</th>
-          <th scope="col" data-sort-key="last_seen" data-sort-default="desc">Last Seen</th>
-          <th scope="col" data-sort-key="advert_count" data-sort-default="desc">Adverts</th>
+          <th scope="col" class="sortable${sortState.column==='name'?' sort-active':''}" data-sort="name">Name${sortArrow('name')}</th>
+          <th scope="col" class="col-pubkey sortable${sortState.column==='public_key'?' sort-active':''}" data-sort="public_key">Public Key${sortArrow('public_key')}</th>
+          <th scope="col" class="sortable${sortState.column==='role'?' sort-active':''}" data-sort="role">Role${sortArrow('role')}</th>
+          <th scope="col" class="sortable${sortState.column==='last_seen'?' sort-active':''}" data-sort="last_seen">Last Seen${sortArrow('last_seen')}</th>
+          <th scope="col" class="sortable${sortState.column==='advert_count'?' sort-active':''}" data-sort="advert_count">Adverts${sortArrow('advert_count')}</th>
         </tr></thead>
         <tbody id="nodesBody"></tbody>
       </table>`;
@@ -928,7 +868,7 @@
     const nodeTabs = document.getElementById('nodeTabs');
     initTabBar(nodeTabs);
     el.querySelectorAll('.node-tab').forEach(btn => {
-      btn.addEventListener('click', () => { activeTab = btn.dataset.tab; updateNodesUrl(); loadNodes(); });
+      btn.addEventListener('click', () => { activeTab = btn.dataset.tab; loadNodes(); });
     });
 
     // Filter changes
@@ -944,18 +884,10 @@
       });
     });
 
-    // Initialize TableSort on nodes table (handles header clicks, indicators, persistence)
-    // We use onSort callback to re-render rows (sorting is done at JS-array level in renderRows
-    // because of claimed/favorites pinning logic that TableSort can't handle)
-    var nodesTableEl = document.getElementById('nodesTable');
-    if (nodesTableEl && window.TableSort) {
-      _nodesTableSortCtrl = TableSort.init(nodesTableEl, {
-        defaultColumn: 'last_seen',
-        defaultDirection: 'desc',
-        storageKey: 'meshcore-nodes-sort',
-        onSort: function () { renderRows(); }
-      });
-    }
+    // Sortable column headers
+    el.querySelectorAll('th.sortable').forEach(th => {
+      th.addEventListener('click', () => { toggleSort(th.dataset.sort); renderLeft(); });
+    });
 
     // Delegated click/keyboard handler for table rows
     const tbody = document.getElementById('nodesBody');
@@ -984,17 +916,6 @@
       }
     });
 
-    // #630: Close button for node detail panel (important for mobile full-screen overlay)
-    document.getElementById('nodesRight').addEventListener('click', function(e) {
-      if (e.target.closest('.panel-close-btn')) {
-        const panel = document.getElementById('nodesRight');
-        panel.classList.add('empty');
-        panel.innerHTML = '<span>Select a node to view details</span>';
-        selectedKey = null;
-        renderRows();
-      }
-    });
-
     renderRows();
   }
 
@@ -1082,7 +1003,6 @@
     const dupBadge = dupNameBadge(n.name, n.public_key, dupMap);
 
     panel.innerHTML = `
-      <button class="panel-close-btn" title="Close detail pane (Esc)">✕</button>
       <div class="node-detail">
         <div class="node-detail-name">${escapeHtml(n.name || '(unnamed)')}${dupBadge}</div>
         <div class="node-detail-role">${renderNodeBadges(n, roleColor)}
@@ -1276,29 +1196,11 @@
   window._nodesIsAdvertMessage = isAdvertMessage;
   window._nodesGetAllNodes = function() { return _allNodes; };
   window._nodesSetAllNodes = function(n) { _allNodes = n; };
-  window._nodesToggleSort = function(col) {
-    if (_nodesTableSortCtrl) { _nodesTableSortCtrl.sort(col); return; }
-    // Fallback for tests without DOM
-    var st = _getSortState();
-    var descDefault = ['last_seen', 'advert_count'];
-    if (st.column === col) {
-      _fallbackSortState = { column: col, direction: st.direction === 'asc' ? 'desc' : 'asc' };
-    } else {
-      _fallbackSortState = { column: col, direction: descDefault.indexOf(col) >= 0 ? 'desc' : 'asc' };
-    }
-    localStorage.setItem('meshcore-nodes-sort', JSON.stringify(_fallbackSortState));
-  };
+  window._nodesToggleSort = toggleSort;
   window._nodesSortNodes = sortNodes;
-  window._nodesSortArrow = function(col) {
-    var st = _getSortState();
-    if (st.column !== col) return '';
-    return '<span class="sort-arrow">' + (st.direction === 'asc' ? '▲' : '▼') + '</span>';
-  };
-  window._nodesGetSortState = _getSortState;
-  window._nodesSetSortState = function(s) {
-    _fallbackSortState = s;
-    if (_nodesTableSortCtrl) _nodesTableSortCtrl.sort(s.column, s.direction);
-  };
+  window._nodesSortArrow = sortArrow;
+  window._nodesGetSortState = function() { return sortState; };
+  window._nodesSetSortState = function(s) { sortState = s; };
   window._nodesSyncClaimedToFavorites = syncClaimedToFavorites;
   window._nodesRenderNodeTimestampHtml = renderNodeTimestampHtml;
   window._nodesRenderNodeTimestampText = renderNodeTimestampText;

public/packets.js

@@ -33,26 +33,7 @@
   let totalCount = 0;
   let expandedHashes = new Set();
   let hopNameCache = {};
-  let _tableSortInstance = null;
-  let _packetSortColumn = null;
-  let _packetSortDirection = 'desc';
   let showHexHashes = localStorage.getItem('meshcore-hex-hashes') === 'true';
-  var _pendingUrlRegion = null;
-
-  var DEFAULT_TIME_WINDOW = 15;
-
-  function buildPacketsQuery(timeWindowMin, regionParam) {
-    var parts = [];
-    if (timeWindowMin && timeWindowMin !== DEFAULT_TIME_WINDOW) parts.push('timeWindow=' + timeWindowMin);
-    if (regionParam) parts.push('region=' + encodeURIComponent(regionParam));
-    return parts.length ? '?' + parts.join('&') : '';
-  }
-  window.buildPacketsQuery = buildPacketsQuery;
-
-  function updatePacketsUrl() {
-    history.replaceState(null, '', '#/packets' + buildPacketsQuery(savedTimeWindowMin, RegionFilter.getRegionParam()));
-  }
-
   let filtersBuilt = false;
   let _renderTimer = null;
   function scheduleRender() {
@@ -82,9 +63,7 @@
   const getParsedDecoded = window.getParsedDecoded;
 
   // --- Virtual scroll state ---
-  let VSCROLL_ROW_HEIGHT = 36;    // measured dynamically on first render; fallback 36px
-  let _vscrollRowHeightMeasured = false;
-  let _vscrollTheadHeight = 40;   // measured dynamically on first render; fallback 40px
+  const VSCROLL_ROW_HEIGHT = 36;  // estimated row height in px
   const VSCROLL_BUFFER = 30;      // extra rows above/below viewport
   let _displayPackets = [];       // filtered packets for current view
   let _displayGrouped = false;    // whether _displayPackets is in grouped mode
@@ -99,37 +78,6 @@
   let _wsRenderDirty = false;     // dirty flag for rAF render coalescing (#396)
   let _observerFilterSet = null;  // cached Set from filters.observer, hoisted above loops (#427)
 
-  // Pure function: calculate visible entry range from scroll state.
-  // Extracted for testability (#405, #409).
-  function _calcVisibleRange(offsets, entryCount, scrollTop, viewportHeight, rowHeight, theadHeight, buffer) {
-    const adjustedScrollTop = Math.max(0, scrollTop - theadHeight);
-    const firstDomRow = Math.floor(adjustedScrollTop / rowHeight);
-    const visibleDomCount = Math.ceil(viewportHeight / rowHeight);
-
-    // Binary search for first entry whose cumulative offset covers firstDomRow
-    let lo = 0, hi = entryCount;
-    while (lo < hi) {
-      const mid = (lo + hi) >>> 1;
-      if (offsets[mid + 1] <= firstDomRow) lo = mid + 1;
-      else hi = mid;
-    }
-    const firstEntry = lo;
-
-    // Binary search for last visible entry
-    const lastDomRow = firstDomRow + visibleDomCount;
-    lo = firstEntry; hi = entryCount;
-    while (lo < hi) {
-      const mid = (lo + hi) >>> 1;
-      if (offsets[mid + 1] <= lastDomRow) lo = mid + 1;
-      else hi = mid;
-    }
-    const lastEntry = Math.min(lo + 1, entryCount);
-
-    const startIdx = Math.max(0, firstEntry - buffer);
-    const endIdx = Math.min(entryCount, lastEntry + buffer);
-    return { startIdx, endIdx, firstEntry, lastEntry };
-  }
-
   function closeDetailPanel() {
     var panel = document.getElementById('pktRight');
     if (panel) {
@@ -332,19 +280,8 @@
         filters.node = routeParam;
       }
     }
-
-    // Read URL params (router strips query from routeParam; read from location.hash)
-    var _initUrlParams = getHashParams();
-    var _urlTimeWindow = Number(_initUrlParams.get('timeWindow'));
-    if (Number.isFinite(_urlTimeWindow) && _urlTimeWindow > 0) {
-      savedTimeWindowMin = _urlTimeWindow;
-      localStorage.setItem('meshcore-time-window', String(_urlTimeWindow));
-    }
-    var _urlRegion = _initUrlParams.get('region');
-    if (_urlRegion) _pendingUrlRegion = _urlRegion;
-
     app.innerHTML = `<div class="split-layout detail-collapsed">
-      <div class="panel-left" id="pktLeft" aria-live="polite" aria-relevant="additions removals"></div>
+      <div class="panel-left" id="pktLeft"></div>
       <div class="panel-right empty" id="pktRight" aria-live="polite">
         <div class="panel-resize-handle" id="pktResizeHandle"></div>
         ${PANEL_CLOSE_HTML}
@@ -529,12 +466,8 @@
               if (h) hashIndex.set(h, newGroup);
             }
           }
-          // Re-sort by active sort column (or latest DESC as default), then evict oldest beyond the limit
-          if (_packetSortColumn) {
-            sortPacketsArray();
-          } else {
-            packets.sort((a, b) => (b.latest || '').localeCompare(a.latest || ''));
-          }
+          // Re-sort by latest DESC, then evict oldest beyond the limit
+          packets.sort((a, b) => (b.latest || '').localeCompare(a.latest || ''));
           if (packets.length > PACKET_LIMIT) {
             const evicted = packets.splice(PACKET_LIMIT);
             for (const p of evicted) { if (p.hash) hashIndex.delete(p.hash); }
@@ -555,7 +488,6 @@
     clearTimeout(_renderTimer);
     if (wsHandler) offWS(wsHandler);
     wsHandler = null;
-    if (_tableSortInstance) { _tableSortInstance.destroy(); _tableSortInstance = null; }
     detachVScrollListener();
     clearTimeout(_wsRenderTimer);
     if (_wsRafId) { cancelAnimationFrame(_wsRafId); _wsRafId = null; }
@@ -684,7 +616,6 @@
         }
       }
 
-      sortPacketsArray();
       renderLeft();
     } catch (e) {
       console.error('Failed to load packets:', e);
@@ -775,9 +706,9 @@
       </div>
       <table class="data-table" id="pktTable">
         <thead><tr>
-          <th scope="col"></th><th scope="col" class="col-region" data-sort-key="region">Region</th><th scope="col" class="col-time" data-sort-key="time" data-type="date">Time</th><th scope="col" class="col-hash" data-sort-key="hash">Hash</th><th scope="col" class="col-size" data-sort-key="size" data-type="numeric">Size</th>
-          <th scope="col" class="col-hashsize" data-sort-key="hb" data-type="numeric">HB</th>
-          <th scope="col" class="col-type" data-sort-key="type">Type</th><th scope="col" class="col-observer" data-sort-key="observer">Observer</th><th scope="col" class="col-path" data-sort-key="path">Path</th><th scope="col" class="col-rpt" data-sort-key="rpt" data-type="numeric">Rpt</th><th scope="col" class="col-details">Details</th>
+          <th scope="col"></th><th scope="col" class="col-region">Region</th><th scope="col" class="col-time">Time</th><th scope="col" class="col-hash">Hash</th><th scope="col" class="col-size">Size</th>
+          <th scope="col" class="col-hashsize">HB</th>
+          <th scope="col" class="col-type">Type</th><th scope="col" class="col-observer">Observer</th><th scope="col" class="col-path">Path</th><th scope="col" class="col-rpt">Rpt</th><th scope="col" class="col-details">Details</th>
         </tr></thead>
         <tbody id="pktBody"></tbody>
       </table>
@@ -785,11 +716,7 @@
 
     // Init shared RegionFilter component
     RegionFilter.init(document.getElementById('packetsRegionFilter'), { dropdown: true });
-    if (_pendingUrlRegion) {
-      RegionFilter.setSelected(_pendingUrlRegion.split(',').filter(Boolean));
-      _pendingUrlRegion = null;
-    }
-    RegionFilter.onChange(function() { updatePacketsUrl(); loadPackets(); });
+    RegionFilter.onChange(function() { loadPackets(); });
 
     // --- Packet Filter Language ---
     (function() {
@@ -939,7 +866,6 @@
       savedTimeWindowMin = Number(fTimeWindow.value);
       if (!Number.isFinite(savedTimeWindowMin) || savedTimeWindowMin <= 0) savedTimeWindowMin = 15;
       localStorage.setItem('meshcore-time-window', fTimeWindow.value);
-      updatePacketsUrl();
       loadPackets();
     });
 
@@ -1175,33 +1101,6 @@
 
     renderTableRows();
     makeColumnsResizable('#pktTable', 'meshcore-pkt-col-widths');
-
-    // Initialize table sorting (virtual scroll — sort data array, not DOM)
-    if (window.TableSort) {
-      var pktTableEl = document.getElementById('pktTable');
-      if (pktTableEl) {
-        if (_tableSortInstance) _tableSortInstance.destroy();
-        _tableSortInstance = TableSort.init(pktTableEl, {
-          defaultColumn: 'time',
-          defaultDirection: 'desc',
-          storageKey: 'meshcore-packets-sort',
-          domReorder: false,
-          onSort: function(column, direction) {
-            _packetSortColumn = column;
-            _packetSortDirection = direction;
-            sortPacketsArray();
-            renderTableRows();
-          }
-        });
-        // Apply initial sort state from TableSort
-        if (_tableSortInstance) {
-          var st = _tableSortInstance.getState();
-          _packetSortColumn = st.column;
-          _packetSortDirection = st.direction;
-          sortPacketsArray();
-        }
-      }
-    }
   }
 
   // Build HTML for a single grouped packet row
@@ -1378,14 +1277,35 @@
     // Calculate visible range based on scroll position
     const scrollTop = scrollContainer.scrollTop;
     const viewportHeight = scrollContainer.clientHeight;
-    // Account for thead height (measured dynamically)
-    const theadEl = scrollContainer.querySelector('thead');
-    if (theadEl) _vscrollTheadHeight = theadEl.offsetHeight || _vscrollTheadHeight;
+    // Account for thead height (~40px)
+    const theadHeight = 40;
+    const adjustedScrollTop = Math.max(0, scrollTop - theadHeight);
 
-    const { startIdx, endIdx } = _calcVisibleRange(
-      offsets, _displayPackets.length, scrollTop, viewportHeight,
-      VSCROLL_ROW_HEIGHT, _vscrollTheadHeight, VSCROLL_BUFFER
-    );
+    // Find the first entry whose cumulative row offset covers the scroll position
+    const firstDomRow = Math.floor(adjustedScrollTop / VSCROLL_ROW_HEIGHT);
+    const visibleDomCount = Math.ceil(viewportHeight / VSCROLL_ROW_HEIGHT);
+
+    // Binary search for entry index containing firstDomRow
+    let lo = 0, hi = _displayPackets.length;
+    while (lo < hi) {
+      const mid = (lo + hi) >>> 1;
+      if (offsets[mid + 1] <= firstDomRow) lo = mid + 1;
+      else hi = mid;
+    }
+    const firstEntry = lo;
+
+    // Find entry index covering last visible DOM row
+    const lastDomRow = firstDomRow + visibleDomCount;
+    lo = firstEntry; hi = _displayPackets.length;
+    while (lo < hi) {
+      const mid = (lo + hi) >>> 1;
+      if (offsets[mid + 1] <= lastDomRow) lo = mid + 1;
+      else hi = mid;
+    }
+    const lastEntry = Math.min(lo + 1, _displayPackets.length);
+
+    const startIdx = Math.max(0, firstEntry - VSCROLL_BUFFER);
+    const endIdx = Math.min(_displayPackets.length, lastEntry + VSCROLL_BUFFER);
 
     // Skip DOM rebuild if visible range hasn't changed
     if (startIdx === _lastVisibleStart && endIdx === _lastVisibleEnd) {
@@ -1416,14 +1336,6 @@
       tbody.appendChild(topSpacer);
       tbody.insertAdjacentHTML('beforeend', visibleHtml);
       tbody.appendChild(bottomSpacer);
-      // Measure actual row height from first rendered data row (#407)
-      if (!_vscrollRowHeightMeasured) {
-        const firstRow = topSpacer.nextElementSibling;
-        if (firstRow && firstRow !== bottomSpacer) {
-          const h = firstRow.offsetHeight;
-          if (h > 0) { VSCROLL_ROW_HEIGHT = h; _vscrollRowHeightMeasured = true; }
-        }
-      }
       if (window.__PERF_LOG_RENDER) console.log('[perf] renderVisibleRows: full rebuild %d entries, %.2fms', endIdx - startIdx, performance.now() - _rvr_t0);
       return;
     }
@@ -1483,55 +1395,6 @@
     _vsScrollHandler = null;
   }
 
-  /** Sort the packets array by the current sort column. Called before renderTableRows. */
-  function sortPacketsArray() {
-    if (!_packetSortColumn || !packets.length) return;
-    var col = _packetSortColumn;
-    var dir = _packetSortDirection === 'asc' ? 1 : -1;
-
-    var accessor;
-    switch (col) {
-      case 'time': accessor = function(p) { return p.latest || p.timestamp || ''; }; break;
-      case 'type': accessor = function(p) { return typeName(p.payload_type); }; break;
-      case 'hash': accessor = function(p) { return p.hash || ''; }; break;
-      case 'observer': accessor = function(p) { return obsName(p.observer_id); }; break;
-      case 'size': accessor = function(p) { return p.packet_size || 0; }; break;
-      case 'hb': accessor = function(p) { return p.hash_byte_count != null ? p.hash_byte_count : (p.hash_size || 0); }; break;
-      case 'rpt': accessor = function(p) {
-        try { var pj = typeof p.path_json === 'string' ? JSON.parse(p.path_json) : p.path_json; return Array.isArray(pj) ? pj.length : 0; } catch(e) { return 0; }
-      }; break;
-      case 'region': accessor = function(p) { return (regionMap && regionMap[p.observer_id]) || ''; }; break;
-      case 'path': accessor = function(p) {
-        try { var pj = typeof p.path_json === 'string' ? JSON.parse(p.path_json) : p.path_json; return Array.isArray(pj) ? pj.join(',') : ''; } catch(e) { return ''; }
-      }; break;
-      default: return; // unsortable column
-    }
-
-    // Choose comparator based on column type
-    var isNumeric = (col === 'size' || col === 'hb' || col === 'rpt');
-    var isDate = (col === 'time');
-
-    packets.sort(function(a, b) {
-      var va = accessor(a), vb = accessor(b);
-      var result;
-      if (isDate) {
-        result = TableSort.comparators.date(va, vb);
-      } else if (isNumeric) {
-        result = TableSort.comparators.numeric(va, vb);
-      } else {
-        result = TableSort.comparators.text(va, vb);
-      }
-      // Stable tiebreaker: sort by timestamp (desc) when primary values are equal
-      if (result === 0 && !isDate) {
-        result = TableSort.comparators.date(
-          a.timestamp || a.first_seen || '',
-          b.timestamp || b.first_seen || ''
-        ) * -1; // desc (newest first)
-      }
-      return dir * result;
-    });
-  }
-
   async function renderTableRows() {
     const tbody = document.getElementById('pktBody');
     if (!tbody) return;
@@ -1762,7 +1625,7 @@
 
     // Parse hash size from path byte
     const rawPathByte = pkt.raw_hex ? parseInt(pkt.raw_hex.slice(2, 4), 16) : NaN;
-    const hashSize = (isNaN(rawPathByte) || (rawPathByte & 0x3F) === 0) ? null : ((rawPathByte >> 6) + 1);
+    const hashSize = isNaN(rawPathByte) ? null : ((rawPathByte >> 6) + 1);
 
     const size = pkt.raw_hex ? Math.floor(pkt.raw_hex.length / 2) : 0;
     const typeName = payloadTypeName(pkt.payload_type);
@@ -1984,7 +1847,7 @@
     const pathByte0 = parseInt(buf.slice(2, 4), 16);
     const hashSizeVal = isNaN(pathByte0) ? '?' : ((pathByte0 >> 6) + 1);
     const hashCountVal = isNaN(pathByte0) ? '?' : (pathByte0 & 0x3F);
-    rows += fieldRow(1, 'Path Length', '0x' + (buf.slice(2, 4) || '??'), hashCountVal === 0 ? `hash_count=0 (direct advert)` : `hash_size=${hashSizeVal} byte${hashSizeVal !== 1 ? 's' : ''}, hash_count=${hashCountVal}`);
+    rows += fieldRow(1, 'Path Length', '0x' + (buf.slice(2, 4) || '??'), `hash_size=${hashSizeVal} byte${hashSizeVal !== 1 ? 's' : ''}, hash_count=${hashCountVal}`);
 
     // Transport codes
     let off = 2;
@@ -2012,7 +1875,7 @@
     rows += sectionRow('Payload — ' + payloadTypeName(pkt.payload_type), 'section-payload');
 
     if (decoded.type === 'ADVERT') {
-      if (hashCountVal !== 0) rows += fieldRow(1, 'Advertised Hash Size', hashSizeVal + ' byte' + (hashSizeVal !== 1 ? 's' : ''), 'From path byte 0x' + (buf.slice(2, 4) || '??') + ' — bits 7-6 = ' + (hashSizeVal - 1));
+      rows += fieldRow(1, 'Advertised Hash Size', hashSizeVal + ' byte' + (hashSizeVal !== 1 ? 's' : ''), 'From path byte 0x' + (buf.slice(2, 4) || '??') + ' — bits 7-6 = ' + (hashSizeVal - 1));
       rows += fieldRow(off, 'Public Key (32B)', truncate(decoded.pubKey || '', 24), '');
       rows += fieldRow(off + 32, 'Timestamp (4B)', decoded.timestampISO || '', 'Unix: ' + (decoded.timestamp || ''));
       rows += fieldRow(off + 36, 'Signature (64B)', truncate(decoded.signature || '', 24), '');
@@ -2174,12 +2037,6 @@
         html += kv(k, String(v));
       }
     }
-    // Special handling for advert signature validation
-    if (h.payloadType === 4 && p.signatureValid !== undefined) {
-      const status = p.signatureValid ? 'Valid' : 'Invalid';
-      const badgeClass = p.signatureValid ? 'badge-success' : 'badge-danger';
-      html += kv('Signature', `<span class="badge ${badgeClass}">${status}</span>`);
-    }
     html += '</div></div>';
 
     // Raw hex
@@ -2310,10 +2167,7 @@
     init: function(app, routeParam) {
       _themeRefreshHandler = () => { if (typeof renderTableRows === 'function') renderTableRows(); };
       window.addEventListener('theme-refresh', _themeRefreshHandler);
-      var result = init(app, routeParam);
-      // Install channel color picker on packets table (M2, #271)
-      if (window.ChannelColorPicker) window.ChannelColorPicker.installPacketsTable();
-      return result;
+      return init(app, routeParam);
     },
     destroy: function() {
       if (_themeRefreshHandler) { window.removeEventListener('theme-refresh', _themeRefreshHandler); _themeRefreshHandler = null; }
@@ -2324,7 +2178,6 @@
   // Standalone packet detail page: #/packet/123 or #/packet/HASH
   // Expose pure functions for unit testing (vm.createContext pattern)
   if (typeof window !== 'undefined') {
-    document.addEventListener('channel-colors-changed', function() { renderVisibleRows(); });
     window._packetsTestAPI = {
       typeName,
       obsName,
@@ -2344,7 +2197,6 @@
       _refreshRowCountsIfDirty,
       buildGroupRowHtml,
       buildFlatRowHtml,
-      _calcVisibleRange,
     };
   }
 

public/region-filter.js

@@ -6,7 +6,6 @@
   var _regions = {};       // { code: label }
   var _selected = null;    // Set of selected region codes, null = all
   var _listeners = [];
-  var _container = null;
   var _loaded = false;
 
   function loadFromStorage() {
@@ -200,19 +199,11 @@
   /** Initialize filter in a container, fetch regions, render, return promise.
    *  Options: { dropdown: true } to force dropdown mode regardless of region count */
   async function initFilter(container, opts) {
-    _container = container;
     if (opts && opts.dropdown) container._forceDropdown = true;
     await fetchRegions();
     render(container);
   }
 
-  /** Override selected regions (e.g. from URL param). Persists to localStorage and re-renders. */
-  function setSelected(codesArray) {
-    _selected = (codesArray && codesArray.length > 0) ? new Set(codesArray) : null;
-    saveToStorage();
-    if (_container) render(_container);
-  }
-
   // Expose globally
   window.RegionFilter = {
     init: initFilter,
@@ -222,7 +213,6 @@
     regionQueryString: regionQueryString,
     onChange: onChange,
     offChange: offChange,
-    fetchRegions: fetchRegions,
-    setSelected: setSelected
+    fetchRegions: fetchRegions
   };
 })();

public/style.css

@@ -30,7 +30,6 @@
   --content-bg: var(--surface-0);
   --card-bg: var(--surface-1);
   --hover-bg: rgba(0,0,0, 0.04);
-  --trace-ghost-color: #94a3b8;
 }
 
 /* ⚠️ DARK THEME VARIABLES — KEEP BOTH BLOCKS IN SYNC
@@ -56,7 +55,6 @@
     --input-bg: #1e1e34;
     --selected-bg: #1e3a5f;
     --hover-bg: rgba(255,255,255, 0.06);
-    --trace-ghost-color: #94a3b8;
     --section-bg: #1e1e34;
   }
 }
@@ -80,7 +78,6 @@
   --input-bg: #1e1e34;
   --selected-bg: #1e3a5f;
   --hover-bg: rgba(255,255,255, 0.06);
-  --trace-ghost-color: #94a3b8;
   --section-bg: #1e1e34;
 }
 
@@ -1187,8 +1184,6 @@ button.ch-item.ch-item-encrypted .ch-badge { filter: grayscale(0.6); }
 .hash-bar-value { min-width: 120px; text-align: right; font-size: 13px; font-weight: 600; }
 .badge-hash-1 { background: #ef444420; color: var(--status-red); }
 .badge-hash-2 { background: #22c55e20; color: var(--status-green); }
-.badge-success { background: #22c55e20; color: var(--status-green); }
-.badge-danger { background: #ef444420; color: var(--status-red); }
 .badge-hash-3 { background: #3b82f620; color: var(--accent); }
 .timeline-legend { display: flex; gap: 16px; justify-content: center; margin-top: 8px; font-size: 12px; }
 .legend-dot { display: inline-block; width: 10px; height: 10px; border-radius: 50%; margin-right: 4px; vertical-align: middle; }
@@ -2042,172 +2037,3 @@ tr[data-hops]:hover { background: rgba(59,130,246,0.1); }
   .rf-time-selector { gap: 3px; }
   .rf-custom-inputs { margin-left: 0; margin-top: 4px; flex-wrap: wrap; }
 }
-
-/* Channel Color Picker Popover (M2, #271) */
-/* === Channel Color Picker (#674) === */
-.cc-picker-popover {
-  position: fixed;
-  z-index: 9999;
-  background: var(--bg-secondary, #1e1e1e);
-  border: 1px solid var(--border-color, #333);
-  border-radius: 8px;
-  padding: 8px;
-  box-shadow: 0 4px 12px rgba(0,0,0,0.3);
-}
-.cc-picker-swatches {
-  display: flex;
-  gap: 6px;
-}
-.cc-swatch {
-  width: 24px;
-  height: 24px;
-  border-radius: 50%;
-  border: 2px solid transparent;
-  cursor: pointer;
-  padding: 0;
-  transition: border-color 0.15s;
-}
-.cc-swatch:hover { border-color: rgba(255,255,255,0.6); }
-.cc-swatch:focus-visible { border-color: #fff; outline: 2px solid var(--accent, #3b82f6); outline-offset: 1px; }
-.cc-swatch-active { border-color: #fff; }
-.cc-picker-clear {
-  display: block;
-  width: 100%;
-  margin-top: 6px;
-  padding: 4px 0;
-  font-size: 11px;
-  color: var(--text-muted, #888);
-  background: none;
-  border: none;
-  cursor: pointer;
-  text-align: center;
-}
-.cc-picker-clear:hover { color: var(--text-primary, #e0e0e0); }
-
-/* Color dot affordance (#674) */
-.ch-color-dot {
-  display: inline-block;
-  width: 12px;
-  height: 12px;
-  border-radius: 50%;
-  border: 1.5px solid rgba(255,255,255,0.3);
-  cursor: pointer;
-  vertical-align: middle;
-  margin-left: 6px;
-  flex-shrink: 0;
-}
-.ch-color-dot:not([style*="background"]) {
-  background: transparent;
-  border-style: dashed;
-  border-color: var(--text-muted, #888);
-}
-
-/* Mobile bottom-sheet + larger touch targets (#674) */
-@media (pointer: coarse) {
-  .ch-color-dot {
-    width: 20px;
-    height: 20px;
-    margin-left: 8px;
-  }
-  .cc-swatch {
-    width: 36px;
-    height: 36px;
-  }
-  .cc-picker-swatches {
-    justify-content: center;
-    gap: 10px;
-  }
-  .cc-picker-popover {
-    position: fixed !important;
-    bottom: 0 !important;
-    left: 0 !important;
-    right: 0 !important;
-    top: auto !important;
-    width: 100% !important;
-    max-width: 100% !important;
-    border-radius: 12px 12px 0 0;
-    padding: 16px;
-    padding-bottom: calc(16px + env(safe-area-inset-bottom));
-    box-sizing: border-box;
-  }
-}
-
-/* === #630 — Mobile Accessibility Fixes === */
-
-/* #630-1: Touch targets — minimum 44px on touch devices */
-@media (pointer: coarse) {
-  .filter-bar .btn,
-  .filter-group .btn,
-  .tab-btn,
-  .filter-bar input,
-  .filter-bar select,
-  .nav-btn,
-  .region-pill,
-  .region-dropdown-trigger,
-  .multi-select-trigger,
-  .node-count-pill,
-  .analytics-time-range button,
-  .detail-back-btn,
-  .filter-toggle-btn {
-    min-height: 44px;
-    min-width: 44px;
-  }
-  .filter-bar input,
-  .filter-bar select {
-    height: 44px;
-  }
-  .region-dropdown-trigger,
-  .multi-select-trigger {
-    height: 44px;
-  }
-}
-
-/* #630-3: Status text labels — visually hidden text for screen readers */
-.sr-status-label { font-size: 11px; margin-left: 4px; }
-
-/* #630-4: Detail panel as full-width overlay on mobile */
-@media (max-width: 640px) {
-  .split-layout .panel-right:not(.empty) {
-    display: block;
-    position: fixed;
-    top: 52px;
-    left: 0;
-    right: 0;
-    bottom: 0;
-    width: 100%;
-    min-width: 0;
-    z-index: 150;
-    overflow-y: auto;
-    -webkit-overflow-scrolling: touch;
-  }
-}
-
-/* #630-5: Analytics tabs — horizontal scroll on small screens */
-@media (max-width: 640px) {
-  .analytics-tabs {
-    flex-wrap: nowrap;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch;
-    scrollbar-width: thin;
-    padding-bottom: 4px;
-  }
-  .analytics-tabs .tab-btn {
-    flex-shrink: 0;
-    white-space: nowrap;
-  }
-}
-
-/* #630-6: Tables — horizontal scroll wrapper */
-.table-scroll-wrap {
-  overflow-x: auto;
-  -webkit-overflow-scrolling: touch;
-}
-@media (max-width: 640px) {
-  .data-table { min-width: 480px; }
-}
-
-/* Table sorting indicators */
-th[data-sort-key] { cursor: pointer; user-select: none; }
-th[data-sort-key]:hover { background: var(--hover-bg, rgba(255,255,255,0.05)); }
-th.sort-active { color: var(--accent, #60a5fa); }
-.sort-arrow { font-size: 0.75em; opacity: 0.8; }

public/table-sort.js

@@ -1,224 +0,0 @@
-/* === CoreScope — table-sort.js === */
-/* Shared table sorting utility. IIFE, no dependencies. */
-'use strict';
-
-window.TableSort = (function() {
-
-  /**
-   * Built-in comparators. Each takes two raw string values (from data-value or textContent)
-   * and returns a number for Array.sort.
-   */
-  var comparators = {
-    text: function(a, b) {
-      if (a == null) a = '';
-      if (b == null) b = '';
-      return String(a).localeCompare(String(b));
-    },
-    numeric: function(a, b) {
-      var na = Number(a), nb = Number(b);
-      var aIsNaN = isNaN(na), bIsNaN = isNaN(nb);
-      if (aIsNaN && bIsNaN) return 0;
-      if (aIsNaN) return 1;   // NaN sorts last
-      if (bIsNaN) return -1;
-      return na - nb;
-    },
-    date: function(a, b) {
-      var ta = a ? new Date(a).getTime() : NaN;
-      var tb = b ? new Date(b).getTime() : NaN;
-      var aIsNaN = isNaN(ta), bIsNaN = isNaN(tb);
-      if (aIsNaN && bIsNaN) return 0;
-      if (aIsNaN) return 1;
-      if (bIsNaN) return -1;
-      return ta - tb;
-    },
-    dbm: function(a, b) {
-      var na = parseFloat(String(a).replace(/\s*dBm\s*/i, ''));
-      var nb = parseFloat(String(b).replace(/\s*dBm\s*/i, ''));
-      var aIsNaN = isNaN(na), bIsNaN = isNaN(nb);
-      if (aIsNaN && bIsNaN) return 0;
-      if (aIsNaN) return 1;
-      if (bIsNaN) return -1;
-      return na - nb;
-    }
-  };
-
-  /**
-   * Resolve the comparator for a <th> element.
-   * Priority: custom comparator from options > data-type attribute > text default.
-   */
-  function resolveComparator(key, thEl, customComparators) {
-    if (customComparators && customComparators[key]) return customComparators[key];
-    var type = thEl.getAttribute('data-type');
-    if (type && comparators[type]) return comparators[type];
-    return comparators.text;
-  }
-
-  /**
-   * Get the sort value for a <td>. Prefers data-value attribute, falls back to textContent.
-   */
-  function getCellValue(td) {
-    if (!td) return '';
-    var dv = td.getAttribute('data-value');
-    return dv != null ? dv : td.textContent.trim();
-  }
-
-  /**
-   * Initialize sorting on a table element.
-   *
-   * @param {HTMLTableElement} tableEl - The table to make sortable
-   * @param {Object} [options]
-   * @param {string} [options.defaultColumn] - data-sort-key of initial sort column
-   * @param {string} [options.defaultDirection='asc'] - 'asc' or 'desc'
-   * @param {string} [options.storageKey] - localStorage key for persistence
-   * @param {Object} [options.comparators] - custom comparator functions keyed by column key
-   * @param {Function} [options.onSort] - callback(column, direction) after sort
-   * @param {boolean} [options.domReorder=true] - if false, skip DOM reorder (for virtual scroll tables)
-   * @returns {Object} instance with sort(), destroy(), getState() methods
-   */
-  function init(tableEl, options) {
-    if (!tableEl) return null;
-    options = options || {};
-    var thead = tableEl.querySelector('thead');
-    if (!thead) return null;
-
-    var state = { column: options.defaultColumn || null, direction: options.defaultDirection || 'asc' };
-    var domReorder = options.domReorder !== false;
-
-    // Restore from localStorage
-    if (options.storageKey) {
-      try {
-        var saved = JSON.parse(localStorage.getItem(options.storageKey));
-        if (saved && saved.column) {
-          state.column = saved.column;
-          state.direction = saved.direction || 'asc';
-        }
-      } catch(e) { /* ignore */ }
-    }
-
-    var ths = thead.querySelectorAll('th[data-sort-key]');
-    var thMap = {}; // key → th element
-    var handlers = []; // for cleanup
-
-    for (var i = 0; i < ths.length; i++) {
-      (function(th) {
-        var key = th.getAttribute('data-sort-key');
-        thMap[key] = th;
-        th.style.cursor = 'pointer';
-        th.setAttribute('tabindex', '0');
-        th.setAttribute('aria-sort', 'none');
-
-        var handler = function(e) {
-          if (e.type === 'keydown' && e.key !== 'Enter' && e.key !== ' ') return;
-          if (e.type === 'keydown') e.preventDefault();
-          if (state.column === key) {
-            state.direction = state.direction === 'asc' ? 'desc' : 'asc';
-          } else {
-            state.column = key;
-            state.direction = options.defaultDirection || 'asc';
-          }
-          doSort();
-        };
-
-        th.addEventListener('click', handler);
-        th.addEventListener('keydown', handler);
-        handlers.push({ el: th, click: handler, keydown: handler });
-      })(ths[i]);
-    }
-
-    // Apply initial sort if defaultColumn is set
-    if (state.column && thMap[state.column]) {
-      updateArrows();
-      if (domReorder) sortDOM();
-    }
-
-    function doSort() {
-      updateArrows();
-      if (options.storageKey) {
-        try { localStorage.setItem(options.storageKey, JSON.stringify(state)); } catch(e) { /* ignore */ }
-      }
-      if (domReorder) sortDOM();
-      if (options.onSort) options.onSort(state.column, state.direction);
-    }
-
-    function updateArrows() {
-      for (var k in thMap) {
-        var th = thMap[k];
-        // Remove existing arrow
-        var arrow = th.querySelector('.sort-arrow');
-        if (arrow) arrow.remove();
-
-        if (k === state.column) {
-          th.classList.add('sort-active');
-          th.setAttribute('aria-sort', state.direction === 'asc' ? 'ascending' : 'descending');
-          var span = document.createElement('span');
-          span.className = 'sort-arrow';
-          span.textContent = state.direction === 'asc' ? ' ▲' : ' ▼';
-          th.appendChild(span);
-        } else {
-          th.classList.remove('sort-active');
-          th.setAttribute('aria-sort', 'none');
-        }
-      }
-    }
-
-    function sortDOM() {
-      var tbody = tableEl.querySelector('tbody');
-      if (!tbody) return;
-      var th = thMap[state.column];
-      if (!th) return;
-
-      var cmp = resolveComparator(state.column, th, options.comparators);
-      var colIndex = -1;
-      var allThs = thead.querySelectorAll('th');
-      for (var j = 0; j < allThs.length; j++) {
-        if (allThs[j] === th) { colIndex = j; break; }
-      }
-      if (colIndex < 0) return;
-
-      var rows = Array.prototype.slice.call(tbody.querySelectorAll('tr'));
-      var dir = state.direction === 'asc' ? 1 : -1;
-
-      rows.sort(function(rowA, rowB) {
-        var a = getCellValue(rowA.cells[colIndex]);
-        var b = getCellValue(rowB.cells[colIndex]);
-        return dir * cmp(a, b);
-      });
-
-      // DOM reorder via appendChild (no innerHTML rebuild)
-      for (var r = 0; r < rows.length; r++) {
-        tbody.appendChild(rows[r]);
-      }
-    }
-
-    function destroy() {
-      for (var h = 0; h < handlers.length; h++) {
-        handlers[h].el.removeEventListener('click', handlers[h].click);
-        handlers[h].el.removeEventListener('keydown', handlers[h].keydown);
-        // Clean up aria/classes
-        handlers[h].el.removeAttribute('aria-sort');
-        handlers[h].el.classList.remove('sort-active');
-        var arrow = handlers[h].el.querySelector('.sort-arrow');
-        if (arrow) arrow.remove();
-      }
-      handlers = [];
-    }
-
-    function sort(column, direction) {
-      if (column) state.column = column;
-      if (direction) state.direction = direction;
-      doSort();
-    }
-
-    function getState() {
-      return { column: state.column, direction: state.direction };
-    }
-
-    return { sort: sort, destroy: destroy, getState: getState };
-  }
-
-  return {
-    init: init,
-    comparators: comparators
-  };
-
-})();

test-channel-color-picker.js

@@ -1,177 +0,0 @@
-/**
- * Tests for channel color picker fix (#674)
- *
- * Verifies:
- * 1. _ccChannel is set correctly for GRP_TXT packets (flat decoded structure)
- * 2. _ccChannel is NOT set for non-GRP_TXT packets
- * 3. Channel color picker palette is 8 colors
- * 4. getRowStyle uses border-left only (no background tint)
- */
-
-'use strict';
-const vm = require('vm');
-const fs = require('fs');
-const path = require('path');
-
-let passed = 0;
-let failed = 0;
-
-function assert(condition, msg) {
-  if (condition) {
-    passed++;
-    console.log(`  ✓ ${msg}`);
-  } else {
-    failed++;
-    console.error(`  ✗ ${msg}`);
-  }
-}
-
-// --- Test 1: _ccChannel extraction logic (simulates live.js behavior) ---
-console.log('\n=== _ccChannel assignment from flat decoded structure ===');
-
-// Simulate the fixed logic from live.js — uses payload.channel (name string),
-// NOT payload.channelHash (numeric byte). Channel colors are keyed by channel
-// name (e.g. "public", "#test") matching the channels API hash field.
-function extractCcChannel(typeName, pkt) {
-  var _ccPayload = (pkt.decoded || {}).payload || {};
-  if (typeName === 'GRP_TXT' || typeName === 'CHAN') {
-    return _ccPayload.channel || null;
-  }
-  return undefined; // not set
-}
-
-// CHAN with channel name (normal case — ingestor-decrypted WS broadcast)
-var chanPkt = {
-  decoded: {
-    header: { payloadTypeName: 'CHAN' },
-    payload: { type: 'CHAN', channel: '#test', channelHash: 217, text: 'hello' }
-  }
-};
-assert(extractCcChannel('CHAN', chanPkt) === '#test', 'CHAN with channel="#test" → _ccChannel="#test"');
-
-// CHAN with "public" channel
-var publicPkt = {
-  decoded: {
-    header: { payloadTypeName: 'CHAN' },
-    payload: { type: 'CHAN', channel: 'public', text: 'hi' }
-  }
-};
-assert(extractCcChannel('CHAN', publicPkt) === 'public', 'CHAN with channel="public" → _ccChannel="public"');
-
-// GRP_TXT without channel (encrypted, no decryption)
-var encryptedPkt = {
-  decoded: {
-    header: { payloadTypeName: 'GRP_TXT' },
-    payload: { type: 'GRP_TXT', channelHash: 5, mac: 'ab12', encryptedData: 'ff' }
-  }
-};
-assert(extractCcChannel('GRP_TXT', encryptedPkt) === null, 'GRP_TXT without channel field → null');
-
-// Non-GRP_TXT packet — should not set _ccChannel
-var advertPkt = {
-  decoded: {
-    header: { payloadTypeName: 'ADVERT' },
-    payload: { type: 'ADVERT', name: 'Node1' }
-  }
-};
-assert(extractCcChannel('ADVERT', advertPkt) === undefined, 'ADVERT → _ccChannel not set');
-
-// Empty decoded
-var emptyPkt = { decoded: {} };
-assert(extractCcChannel('GRP_TXT', emptyPkt) === null, 'GRP_TXT with empty payload → null');
-
-// --- Test 2: _getChannelStyle fix (simulates fixed logic) ---
-console.log('\n=== _getChannelStyle with flat structure ===');
-
-function simulateGetChannelStyle(pkt, channelColors) {
-  var d = pkt.decoded || {};
-  var h = d.header || {};
-  var p = d.payload || {};
-  var ch = p.channel || null;
-  var typeName = h.payloadTypeName || '';
-  if (typeName !== 'GRP_TXT' && typeName !== 'CHAN') return '';
-  if (!ch) return '';
-  var color = channelColors[ch] || null;
-  if (!color) return '';
-  return 'border-left:3px solid ' + color + ';';
-}
-
-var colors = { '#test': '#ef4444' };
-assert(
-  simulateGetChannelStyle(chanPkt, colors) === 'border-left:3px solid #ef4444;',
-  'getChannelStyle returns border-left for assigned color'
-);
-assert(
-  simulateGetChannelStyle(chanPkt, {}) === '',
-  'getChannelStyle returns empty for unassigned channel'
-);
-assert(
-  simulateGetChannelStyle(advertPkt, colors) === '',
-  'getChannelStyle returns empty for non-GRP_TXT'
-);
-
-// --- Test 3: channel-colors.js getRowStyle uses border-left only ---
-console.log('\n=== channel-colors.js getRowStyle ===');
-
-const ccSource = fs.readFileSync(path.join(__dirname, 'public', 'channel-colors.js'), 'utf8');
-const ccCtx = {
-  window: {},
-  localStorage: {
-    _data: {},
-    getItem(k) { return this._data[k] || null; },
-    setItem(k, v) { this._data[k] = v; }
-  }
-};
-vm.createContext(ccCtx);
-vm.runInContext(ccSource, ccCtx);
-
-// Set a color
-ccCtx.window.ChannelColors.set('5', '#3b82f6');
-var style = ccCtx.window.ChannelColors.getRowStyle('GRP_TXT', '5');
-assert(style === 'border-left:3px solid #3b82f6;', 'getRowStyle returns border-left:3px (no background tint)');
-assert(!style.includes('background'), 'getRowStyle has no background property');
-
-var noStyle = ccCtx.window.ChannelColors.getRowStyle('GRP_TXT', '99');
-assert(noStyle === '', 'getRowStyle returns empty for unassigned channel');
-
-var advertStyle = ccCtx.window.ChannelColors.getRowStyle('ADVERT', '5');
-assert(advertStyle === '', 'getRowStyle returns empty for non-GRP_TXT type');
-
-// --- Test 4: channel-color-picker.js palette ---
-console.log('\n=== channel-color-picker.js palette ===');
-
-const pickerSource = fs.readFileSync(path.join(__dirname, 'public', 'channel-color-picker.js'), 'utf8');
-const pickerCtx = {
-  window: { ChannelColors: ccCtx.window.ChannelColors, matchMedia: () => ({ matches: false }) },
-  document: {
-    createElement: () => ({
-      className: '', style: {}, innerHTML: '',
-      setAttribute: () => {},
-      querySelector: () => ({ textContent: '', style: {}, addEventListener: () => {} }),
-      querySelectorAll: () => [],
-      appendChild: () => {},
-      addEventListener: () => {}
-    }),
-    body: { appendChild: () => {}, style: {} },
-    addEventListener: () => {},
-    removeEventListener: () => {},
-    activeElement: null
-  },
-  setTimeout: (fn) => fn(),
-  Array: Array
-};
-vm.createContext(pickerCtx);
-vm.runInContext(pickerSource, pickerCtx);
-
-assert(pickerCtx.window.ChannelColorPicker != null, 'ChannelColorPicker exported');
-assert(Array.isArray(pickerCtx.window.ChannelColorPicker.PALETTE), 'PALETTE is exported');
-assert(pickerCtx.window.ChannelColorPicker.PALETTE.length === 8, 'PALETTE has exactly 8 colors');
-
-// Verify no teal/rose in palette
-var palette = pickerCtx.window.ChannelColorPicker.PALETTE;
-assert(!palette.includes('#14b8a6'), 'No teal in palette');
-assert(!palette.includes('#f43f5e'), 'No rose in palette');
-
-// --- Summary ---
-console.log(`\n${passed + failed} tests: ${passed} passed, ${failed} failed`);
-process.exit(failed > 0 ? 1 : 0);

test-channel-colors.js

@@ -168,91 +168,6 @@ test('getRowStyle returns empty when channel has no assigned color', function()
   assert.strictEqual(ctx.window.ChannelColors.getRowStyle('GRP_TXT', '#nope'), '');
 });
 
-// ── M2: Channel Color Picker tests ──
-
-test('channel-color-picker.js loads without error in sandbox', function() {
-  const ctx = makeSandbox();
-  // Provide minimal DOM stubs for the picker
-  const elements = {};
-  const createdEls = [];
-  ctx.document = {
-    createElement: function(tag) {
-      var el = {
-        tagName: tag.toUpperCase(),
-        className: '', style: { cssText: '', display: '' },
-        innerHTML: '', textContent: '', title: '',
-        children: [],
-        _attrs: {},
-        _listeners: {},
-        setAttribute: function(k, v) { this._attrs[k] = v; },
-        getAttribute: function(k) { return this._attrs[k] || null; },
-        addEventListener: function(ev, fn, opts) { this._listeners[ev] = fn; },
-        removeEventListener: function() {},
-        appendChild: function(c) { this.children.push(c); return c; },
-        querySelector: function(sel) {
-          // Very basic selector matching for test
-          if (sel === '.cc-picker-swatches') return { addEventListener: function(){}, appendChild: function(c){} };
-          if (sel === '.cc-picker-apply') return { addEventListener: function(){} };
-          if (sel === '.cc-picker-clear') return { addEventListener: function(){}, style: {} };
-          if (sel === '.cc-picker-close') return { addEventListener: function(){} };
-          if (sel === '.cc-picker-title') return { textContent: '' };
-          if (sel === '.cc-picker-input') return { value: '#000000' };
-          return null;
-        },
-        querySelectorAll: function() { return []; },
-        classList: { toggle: function(){}, remove: function(){}, add: function(){} },
-        contains: function() { return false; },
-        closest: function() { return null; },
-        getBoundingClientRect: function() { return { width: 200, height: 200 }; }
-      };
-      createdEls.push(el);
-      return el;
-    },
-    getElementById: function() { return null; },
-    addEventListener: function() {},
-    removeEventListener: function() {},
-    body: { appendChild: function(c) {} },
-    querySelectorAll: function() { return []; }
-  };
-  ctx.setTimeout = function(fn) { fn(); };
-  ctx.window.innerWidth = 1024;
-  ctx.window.innerHeight = 768;
-  const pickerSrc = fs.readFileSync(__dirname + '/public/channel-color-picker.js', 'utf8');
-  vm.runInContext(pickerSrc, ctx);
-  assert.ok(ctx.window.ChannelColorPicker, 'ChannelColorPicker should be exported');
-  assert.strictEqual(typeof ctx.window.ChannelColorPicker.install, 'function');
-  assert.strictEqual(typeof ctx.window.ChannelColorPicker.show, 'function');
-  assert.strictEqual(typeof ctx.window.ChannelColorPicker.hide, 'function');
-});
-
-test('ChannelColorPicker.install does not throw when elements missing', function() {
-  const ctx = makeSandbox();
-  ctx.document = {
-    createElement: function() {
-      return { className: '', style: {}, innerHTML: '', _attrs: {}, children: [],
-        setAttribute: function(){}, getAttribute: function(){ return null; },
-        addEventListener: function(){}, appendChild: function(c){ this.children.push(c); return c; },
-        querySelector: function(){ return { addEventListener: function(){}, style: {}, textContent: '' }; },
-        querySelectorAll: function(){ return []; },
-        getBoundingClientRect: function(){ return {width:0,height:0}; },
-        contains: function(){ return false; }
-      };
-    },
-    getElementById: function() { return null; },
-    addEventListener: function() {},
-    removeEventListener: function() {},
-    body: { appendChild: function(){} },
-    querySelectorAll: function() { return []; }
-  };
-  ctx.setTimeout = function(fn) { fn(); };
-  ctx.window.innerWidth = 1024;
-  ctx.window.innerHeight = 768;
-  const pickerSrc = fs.readFileSync(__dirname + '/public/channel-color-picker.js', 'utf8');
-  vm.runInContext(pickerSrc, ctx);
-  // Should not throw when feed/table elements don't exist
-  ctx.window.ChannelColorPicker.install();
-});
-
 // Summary
 console.log(`\n${passed} passed, ${failed} failed\n`);
 process.exit(failed ? 1 : 0);

test-e2e-playwright.js

@@ -1488,7 +1488,7 @@ async function run() {
     const hasTable = await page.$('#fullNeighborsContent .data-table');
     if (hasTable) {
       // Check columns
-      const headers = await page.$$eval('#fullNeighborsContent thead th', ths => ths.map(t => t.textContent.trim().replace(/\s*[▲▼]\s*$/, '')));
+      const headers = await page.$$eval('#fullNeighborsContent thead th', ths => ths.map(t => t.textContent));
       assert(headers.includes('Neighbor'), 'Should have Neighbor column');
       assert(headers.includes('Role'), 'Should have Role column');
       assert(headers.includes('Score'), 'Should have Score column');
@@ -1627,65 +1627,6 @@ async function run() {
     }
   } catch {}
 
-  // --- Group: Deep linking (#536) ---
-
-  // Test: nodes tab deep link
-  await test('Nodes tab deep link restores active tab', async () => {
-    await page.goto(BASE + '#/nodes?tab=repeater', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.node-tab', { timeout: 8000 });
-    const activeTab = await page.$('.node-tab.active');
-    assert(activeTab, 'No active tab found');
-    const tabText = await activeTab.textContent();
-    assert(tabText.includes('Repeater'), `Expected Repeater tab active, got: ${tabText}`);
-    const url = page.url();
-    assert(url.includes('tab=repeater'), `URL should contain tab=repeater, got: ${url}`);
-  });
-
-  // Test: nodes tab click updates URL
-  await test('Nodes tab click updates URL', async () => {
-    await page.goto(BASE + '#/nodes', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.node-tab', { timeout: 8000 });
-    const roomTab = await page.$('.node-tab[data-tab="room"]');
-    assert(roomTab, 'Room tab (data-tab="room") not found — nodes page may not have rendered or tab selector changed');
-    await roomTab.click();
-    await page.waitForTimeout(300);
-    const url = page.url();
-    assert(url.includes('tab=room'), `URL should contain tab=room after click, got: ${url}`);
-  });
-
-  // Test: packets timeWindow deep link
-  await test('Packets timeWindow deep link restores dropdown', async () => {
-    await page.goto(BASE + '#/packets?timeWindow=60', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('#fTimeWindow', { timeout: 8000 });
-    const val = await page.$eval('#fTimeWindow', el => el.value);
-    assert(val === '60', `Expected timeWindow dropdown = 60, got: ${val}`);
-    const url = page.url();
-    assert(url.includes('timeWindow=60'), `URL should still contain timeWindow=60, got: ${url}`);
-  });
-
-  // Test: timeWindow change updates URL
-  await test('Packets timeWindow change updates URL', async () => {
-    await page.goto(BASE + '#/packets', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('#fTimeWindow', { timeout: 8000 });
-    await page.selectOption('#fTimeWindow', '30');
-    await page.waitForTimeout(300);
-    const url = page.url();
-    assert(url.includes('timeWindow=30'), `URL should contain timeWindow=30 after change, got: ${url}`);
-  });
-
-  // Test: channels selected channel survives refresh (already implemented, verify it still works)
-  await test('Channels channel selection is URL-addressable', async () => {
-    await page.goto(BASE + '#/channels', { waitUntil: 'domcontentloaded' });
-    await page.waitForSelector('.ch-item', { timeout: 8000 }).catch(() => null);
-    const firstChannel = await page.$('.ch-item');
-    if (firstChannel) {
-      await firstChannel.click();
-      await page.waitForTimeout(500);
-      const url = page.url();
-      assert(url.includes('#/channels/') || url.includes('#/channels'), `URL should reflect channel selection, got: ${url}`);
-    }
-  });
-
   await browser.close();
 
   // Summary

test-frontend-helpers.js

@@ -75,7 +75,6 @@ function makeSandbox() {
       };
     })(),
     location: { hash: '' },
-    getHashParams: function() { return new URLSearchParams((ctx.location.hash.split('?')[1] || '')); },
     CustomEvent: class CustomEvent {},
     Map,
     Promise,
@@ -2079,151 +2078,6 @@ console.log('\n=== analytics.js: sortChannels ===');
   });
 }
 
-// ===== analytics.js: rfNFColumnChart =====
-console.log('\n=== analytics.js: rfNFColumnChart ===');
-{
-  function makeAnalyticsSandbox2() {
-    const ctx = makeSandbox();
-    ctx.getComputedStyle = () => ({ getPropertyValue: () => '' });
-    ctx.registerPage = () => {};
-    ctx.api = () => Promise.resolve({});
-    ctx.timeAgo = (iso) => iso ? 'x ago' : '—';
-    ctx.RegionFilter = { init: () => {}, onChange: () => {}, regionQueryString: () => '' };
-    ctx.onWS = () => {};
-    ctx.offWS = () => {};
-    ctx.connectWS = () => {};
-    ctx.invalidateApiCache = () => {};
-    ctx.makeColumnsResizable = () => {};
-    ctx.initTabBar = () => {};
-    ctx.IATA_COORDS_GEO = {};
-    loadInCtx(ctx, 'public/roles.js');
-    loadInCtx(ctx, 'public/app.js');
-    try { loadInCtx(ctx, 'public/analytics.js'); } catch (e) {
-      for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-    }
-    return ctx;
-  }
-
-  const ctx2 = makeAnalyticsSandbox2();
-  const rfNFColumnChart = ctx2.window._analyticsRfNFColumnChart;
-
-  test('rfNFColumnChart is exposed', () => assert.ok(rfNFColumnChart, '_analyticsRfNFColumnChart must be exposed'));
-
-  test('returns SVG string with column bars', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -110 },
-      { t: '2024-01-01T00:05:00Z', v: -95 },
-      { t: '2024-01-01T00:10:00Z', v: -80 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(svg.includes('<svg'), 'should produce SVG');
-    assert.ok(svg.includes('class="nf-bar"'), 'should have column bars');
-    assert.ok(svg.includes('Noise floor column chart'), 'should have aria label');
-  });
-
-  test('color-codes bars by threshold', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -110 },  // green (< -100)
-      { t: '2024-01-01T00:05:00Z', v: -95 },   // yellow (-100 to -85)
-      { t: '2024-01-01T00:10:00Z', v: -80 },   // red (>= -85)
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(svg.includes('var(--success'), 'green bar for < -100');
-    assert.ok(svg.includes('var(--warning'), 'yellow bar for -100 to -85');
-    assert.ok(svg.includes('var(--danger'), 'red bar for >= -85');
-  });
-
-  test('includes hover tooltips in bars', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -105 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(svg.includes('<title>NF: -105.0 dBm'), 'tooltip with dBm value');
-  });
-
-  test('handles empty data gracefully', () => {
-    const svg = rfNFColumnChart([], 700, 180, []);
-    assert.ok(svg.includes('<svg'), 'should return empty SVG');
-  });
-
-  test('handles single data point with visible bar', () => {
-    const data = [{ t: '2024-01-01T00:00:00Z', v: -100 }];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(svg.includes('class="nf-bar"'), 'should render single bar');
-    // Bar must have non-zero height (division-by-zero guard)
-    const m = svg.match(/height="([\d.]+)"/);
-    assert.ok(m && parseFloat(m[1]) > 0, 'single data point bar must have non-zero height');
-    assert.ok(!svg.includes('NaN'), 'must not contain NaN');
-  });
-
-  test('handles constant values with visible bars', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -95 },
-      { t: '2024-01-01T00:05:00Z', v: -95 },
-      { t: '2024-01-01T00:10:00Z', v: -95 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    const heights = [...svg.matchAll(/class="nf-bar"[^>]*height="([\d.]+)"/g)].map(m => parseFloat(m[1]));
-    assert.strictEqual(heights.length, 3, 'should render 3 bars');
-    assert.ok(heights.every(h => h > 0), 'all bars must have non-zero height');
-    assert.ok(!svg.includes('NaN'), 'must not contain NaN');
-  });
-
-  test('includes legend', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -110 },
-      { t: '2024-01-01T00:05:00Z', v: -90 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(svg.includes('&lt; -100'), 'legend has green label');
-    assert.ok(svg.includes('-100…-85'), 'legend has yellow label');
-    assert.ok(svg.includes('≥ -85'), 'legend has red label');
-  });
-
-  test('no reference lines (removed per spec)', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -110 },
-      { t: '2024-01-01T00:05:00Z', v: -80 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    assert.ok(!svg.includes('-100 warning'), 'no -100 warning reference line');
-    assert.ok(!svg.includes('-85 critical'), 'no -85 critical reference line');
-    assert.ok(!svg.includes('stroke-dasharray="4,2"'), 'no dashed reference lines');
-  });
-
-  test('renders all bars even with time gaps', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -110 },
-      { t: '2024-01-01T06:00:00Z', v: -95 },  // 6h gap
-      { t: '2024-01-01T06:05:00Z', v: -80 },
-    ];
-    const svg = rfNFColumnChart(data, 700, 180, []);
-    const barCount = (svg.match(/class="nf-bar"/g) || []).length;
-    assert.strictEqual(barCount, 3, 'all 3 bars rendered despite time gap');
-  });
-
-  test('respects shared time axis', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -100 },
-      { t: '2024-01-01T00:05:00Z', v: -95 },
-    ];
-    const minT = new Date('2023-12-31T00:00:00Z').getTime();
-    const maxT = new Date('2024-01-02T00:00:00Z').getTime();
-    const svg = rfNFColumnChart(data, 700, 180, [], minT, maxT);
-    assert.ok(svg.includes('class="nf-bar"'), 'renders with shared time axis');
-  });
-
-  test('renders reboot markers when reboots provided', () => {
-    const data = [
-      { t: '2024-01-01T00:00:00Z', v: -105 },
-      { t: '2024-01-01T01:00:00Z', v: -95 },
-    ];
-    const reboots = [new Date('2024-01-01T00:30:00Z').getTime()];
-    const svg = rfNFColumnChart(data, 700, 180, reboots);
-    assert.ok(svg.includes('reboot'), 'should render reboot marker');
-  });
-}
-
 
 // ===== CUSTOMIZE-V2.JS: core behavior =====
 console.log('\n=== customize-v2.js: core behavior ===');
@@ -2864,6 +2718,7 @@ console.log('\n=== packets.js: savedTimeWindowMin defaults ===');
 // ===== Packets page: virtual scroll infrastructure =====
 {
   console.log('\nPackets page — virtual scroll:');
+  const packetsSource = fs.readFileSync('public/packets.js', 'utf8');
 
   // --- Behavioral tests using extracted logic ---
 
@@ -2888,17 +2743,6 @@ console.log('\n=== packets.js: savedTimeWindowMin defaults ===');
     return 1 + childCount;
   }
 
-  // Load _calcVisibleRange from the actual packets.js via sandbox
-  const pktCtx = makeSandbox();
-  pktCtx.registerPage = (name, handlers) => {};
-  pktCtx.onWS = () => {};
-  pktCtx.offWS = () => {};
-  pktCtx.api = () => Promise.resolve({});
-  pktCtx.window.getParsedPath = () => [];
-  pktCtx.window.getParsedDecoded = () => ({});
-  loadInCtx(pktCtx, 'public/packets.js');
-  const _calcVisibleRange = pktCtx.window._packetsTestAPI._calcVisibleRange;
-
   test('cumulativeRowOffsets computes correct offsets for flat rows', () => {
     const counts = [1, 1, 1, 1, 1];
     const offsets = cumulativeRowOffsets(counts);
@@ -2960,101 +2804,38 @@ console.log('\n=== packets.js: savedTimeWindowMin defaults ===');
     assert.strictEqual(getRowCount(p, true, expanded, null), 1);
   });
 
-  // --- Behavioral tests for _calcVisibleRange (#405, #409) ---
-
-  test('_calcVisibleRange: top of list (scrollTop = 0)', () => {
-    const offsets = cumulativeRowOffsets([1,1,1,1,1,1,1,1,1,1]); // 10 flat items
-    const r = _calcVisibleRange(offsets, 10, 0, 360, 36, 0, 2);
-    assert.strictEqual(r.startIdx, 0, 'start should be 0');
-    assert.ok(r.endIdx <= 10, 'end should not exceed entry count');
-    assert.ok(r.endIdx >= 10, 'with buffer=2, should cover visible + buffer');
+  test('renderVisibleRows uses cumulative offsets not flat entry count', () => {
+    assert.ok(packetsSource.includes('_cumulativeRowOffsets'),
+      'renderVisibleRows should use cumulative row offsets');
+    assert.ok(!packetsSource.includes('const totalRows = _displayPackets.length'),
+      'should NOT use flat array length for total row count');
   });
 
-  test('_calcVisibleRange: middle of list', () => {
-    // 100 flat items, viewport shows ~10 rows, scroll to row 50
-    const offsets = cumulativeRowOffsets(new Array(100).fill(1));
-    const r = _calcVisibleRange(offsets, 100, 50 * 36, 360, 36, 0, 5);
-    assert.strictEqual(r.firstEntry, 50, 'firstEntry should be 50');
-    assert.strictEqual(r.startIdx, 45, 'startIdx = firstEntry - buffer');
-    assert.ok(r.endIdx <= 100);
-    assert.ok(r.endIdx >= 60, 'endIdx should cover visible + buffer');
+  test('renderVisibleRows skips DOM rebuild when range unchanged', () => {
+    assert.ok(packetsSource.includes('startIdx === _lastVisibleStart && endIdx === _lastVisibleEnd'),
+      'should skip rebuild when range is unchanged');
   });
 
-  test('_calcVisibleRange: bottom of list', () => {
-    const offsets = cumulativeRowOffsets(new Array(100).fill(1));
-    // Scroll past the end
-    const r = _calcVisibleRange(offsets, 100, 99 * 36, 360, 36, 0, 5);
-    assert.strictEqual(r.endIdx, 100, 'endIdx clamped to entry count');
-    assert.ok(r.startIdx >= 84, 'startIdx should be near end minus buffer');
+  test('lazy row generation — HTML built only for visible slice', () => {
+    assert.ok(!packetsSource.includes('_lastRenderedRows'),
+      'should NOT have pre-built row HTML cache');
+    assert.ok(packetsSource.includes('_displayPackets.slice(startIdx, endIdx)'),
+      'should slice display packets for visible range on full rebuild');
+    // Incremental path uses builder() per-item in loops; full rebuild uses .map()
+    assert.ok(packetsSource.includes('builder(p, startIdx + i)') || packetsSource.includes('builder(_displayPackets[i], i)'),
+      'should build HTML lazily per visible packet');
   });
 
-  test('_calcVisibleRange: empty array', () => {
-    const offsets = cumulativeRowOffsets([]);
-    const r = _calcVisibleRange(offsets, 0, 0, 360, 36, 0, 5);
-    assert.strictEqual(r.startIdx, 0);
-    assert.strictEqual(r.endIdx, 0);
+  test('observer filter Set is hoisted, not recreated per-packet', () => {
+    assert.ok(packetsSource.includes('_observerFilterSet = filters.observer ? new Set(filters.observer.split'),
+      'observer filter Set should be created once in renderTableRows');
+    assert.ok(packetsSource.includes('_observerFilterSet.has(String(c.observer_id))'),
+      'buildGroupRowHtml should use hoisted _observerFilterSet');
   });
 
-  test('_calcVisibleRange: single item', () => {
-    const offsets = cumulativeRowOffsets([1]);
-    const r = _calcVisibleRange(offsets, 1, 0, 360, 36, 0, 5);
-    assert.strictEqual(r.startIdx, 0);
-    assert.strictEqual(r.endIdx, 1);
-  });
-
-  test('_calcVisibleRange: exact row boundary', () => {
-    const offsets = cumulativeRowOffsets(new Array(20).fill(1));
-    // scrollTop exactly at row 5 boundary
-    const r = _calcVisibleRange(offsets, 20, 5 * 36, 360, 36, 0, 2);
-    assert.strictEqual(r.firstEntry, 5, 'firstEntry at exact boundary');
-    assert.strictEqual(r.startIdx, 3, 'startIdx = firstEntry - buffer');
-  });
-
-  test('_calcVisibleRange: large dataset (30K items)', () => {
-    const offsets = cumulativeRowOffsets(new Array(30000).fill(1));
-    const r = _calcVisibleRange(offsets, 30000, 15000 * 36, 360, 36, 30, 30);
-    // theadHeight=30 means adjustedScrollTop = 15000*36 - 30, so firstDomRow = floor((540000-30)/36) = 14999
-    assert.strictEqual(r.firstEntry, 14999);
-    assert.strictEqual(r.startIdx, 14969);
-    assert.ok(r.endIdx <= 30000);
-    assert.ok(r.endIdx >= 15040);
-  });
-
-  test('_calcVisibleRange: various row heights', () => {
-    const offsets = cumulativeRowOffsets(new Array(50).fill(1));
-    // rowHeight = 24 instead of 36
-    const r = _calcVisibleRange(offsets, 50, 10 * 24, 240, 24, 0, 3);
-    assert.strictEqual(r.firstEntry, 10);
-    assert.strictEqual(r.startIdx, 7);
-  });
-
-  test('_calcVisibleRange: thead offset shifts visible range', () => {
-    const offsets = cumulativeRowOffsets(new Array(20).fill(1));
-    // scrollTop = 40 but theadHeight = 40, so adjustedScrollTop = 0
-    const r = _calcVisibleRange(offsets, 20, 40, 360, 36, 40, 2);
-    assert.strictEqual(r.firstEntry, 0, 'thead offset should be subtracted');
-  });
-
-  test('_calcVisibleRange: expanded groups with variable row counts', () => {
-    // Simulate: item0=1row, item1=5rows(expanded group), item2=1row, item3=3rows, item4=1row
-    const offsets = cumulativeRowOffsets([1, 5, 1, 3, 1]);
-    // Scroll to DOM row 6 (in item2), viewport shows 3 DOM rows
-    const r = _calcVisibleRange(offsets, 5, 6 * 36, 108, 36, 0, 0);
-    assert.strictEqual(r.firstEntry, 2, 'should land in item2 (offsets[2]=6)');
-    assert.strictEqual(r.startIdx, 2);
-  });
-
-  test('_calcVisibleRange: buffer clamped at boundaries', () => {
-    const offsets = cumulativeRowOffsets(new Array(10).fill(1));
-    // At top with buffer=20 (larger than dataset)
-    const r = _calcVisibleRange(offsets, 10, 0, 360, 36, 0, 20);
-    assert.strictEqual(r.startIdx, 0, 'start clamped to 0');
-    assert.strictEqual(r.endIdx, 10, 'end clamped to entry count');
-  });
-
-  // --- Behavioral tests for observer filter logic (#537) ---
-
   test('observer filter in grouped mode includes packet when child matches (#537)', () => {
+    // The display filter should keep a grouped packet whose primary observer_id
+    // does NOT match, but one of its _children does.
     const obsIds = new Set(['OBS_B']);
     const packets = [
       { observer_id: 'OBS_A', _children: [{ observer_id: 'OBS_A' }, { observer_id: 'OBS_B' }] },
@@ -3093,6 +2874,53 @@ console.log('\n=== packets.js: savedTimeWindowMin defaults ===');
     const passes2 = obsSet.has(p2.observer_id) || (p2._children && p2._children.some(c => obsSet.has(String(c.observer_id))));
     assert.ok(!passes2, 'WS filter should reject grouped packet with no matching observers');
   });
+
+  test('packets.js display filter checks _children for observer match (#537)', () => {
+    // Verify the actual source code has the children check
+    assert.ok(
+      packetsSource.includes('p._children) return p._children.some(c => obsIds.has(String(c.observer_id))'),
+      'display filter should check _children for observer match'
+    );
+  });
+
+  test('packets.js WS filter checks _children for observer match (#537)', () => {
+    assert.ok(
+      packetsSource.includes('p._children && p._children.some(c => obsSet.has(String(c.observer_id)))'),
+      'WS filter should check _children for observer match'
+    );
+  });
+
+  test('buildFlatRowHtml has null-safe decoded_json', () => {
+    const flatBuilderMatch = packetsSource.match(/function buildFlatRowHtml[\s\S]*?(?=\n  function )/);
+    assert.ok(flatBuilderMatch, 'buildFlatRowHtml should exist');
+    assert.ok(flatBuilderMatch[0].includes('getParsedDecoded(p)'),
+      'buildFlatRowHtml should use getParsedDecoded for null-safe decoded_json fallback');
+  });
+
+  test('pathHops null guard in buildFlatRowHtml (issue #451)', () => {
+    const flatBuilderMatch = packetsSource.match(/function buildFlatRowHtml[\s\S]*?(?=\n  function )/);
+    assert.ok(flatBuilderMatch, 'buildFlatRowHtml should exist');
+    assert.ok(flatBuilderMatch[0].includes('getParsedPath(p)'),
+      'buildFlatRowHtml should use getParsedPath which guards against null');
+  });
+
+  test('pathHops null guard in detail pane (issue #451)', () => {
+    assert.ok(packetsSource.includes('getParsedPath(pkt)'),
+      'detail pane should use getParsedPath for null-safe path parsing');
+    assert.ok(packetsSource.includes('getParsedDecoded(pkt)'),
+      'detail pane should use getParsedDecoded for null-safe decoded parsing');
+  });
+
+  test('destroy cleans up virtual scroll state', () => {
+    assert.ok(packetsSource.includes('detachVScrollListener'),
+      'destroy should detach virtual scroll listener');
+    assert.ok(packetsSource.includes("_displayPackets = []"),
+      'destroy should reset display packets');
+    assert.ok(packetsSource.includes("_rowCounts = []"),
+      'destroy should reset row counts');
+    assert.ok(packetsSource.includes("_lastVisibleStart = -1"),
+      'destroy should reset visible start');
+  });
 }
 
 // ===== live.js: packetTimestamp =====
@@ -4662,262 +4490,6 @@ console.log('\n=== app.js: routeTypeName/payloadTypeName edge cases ===');
   });
 }
 
-// ===== REGION-FILTER.JS: setSelected =====
-console.log('\n=== region-filter.js: setSelected ===');
-{
-  const ctx = makeSandbox();
-  ctx.fetch = () => Promise.resolve({ json: () => Promise.resolve({ 'US-SFO': 'San Jose', 'US-LAX': 'Los Angeles' }) });
-
-  // Patch createElement to return an object with style property
-  const origCreate = ctx.document.createElement;
-  ctx.document.createElement = () => ({
-    id: '', textContent: '', innerHTML: '',
-    style: {},
-    querySelector: () => null,
-    querySelectorAll: () => [],
-    onclick: null,
-    onchange: null,
-    addEventListener: () => {},
-    removeEventListener: () => {},
-  });
-
-  loadInCtx(ctx, 'public/region-filter.js');
-
-  const RF = ctx.RegionFilter;
-
-  test('setSelected sets region codes', async () => {
-    await RF.init(ctx.document.createElement('div'));
-    RF.setSelected(['US-SFO', 'US-LAX']);
-    assert.strictEqual(RF.getRegionParam(), 'US-SFO,US-LAX');
-  });
-
-  test('setSelected with null clears selection', async () => {
-    await RF.init(ctx.document.createElement('div'));
-    RF.setSelected(['US-SFO']);
-    RF.setSelected(null);
-    assert.strictEqual(RF.getRegionParam(), '');
-  });
-
-  test('setSelected with empty array clears selection', async () => {
-    await RF.init(ctx.document.createElement('div'));
-    RF.setSelected(['US-SFO']);
-    RF.setSelected([]);
-    assert.strictEqual(RF.getRegionParam(), '');
-  });
-}
-
-// ===== NODES.JS: buildNodesQuery =====
-console.log('\n=== nodes.js: buildNodesQuery ===');
-{
-  const ctx = makeSandbox();
-  loadInCtx(ctx, 'public/roles.js');
-  loadInCtx(ctx, 'public/app.js');
-
-  // Provide required globals for nodes.js IIFE to execute
-  ctx.registerPage = () => {};
-  ctx.RegionFilter = { init: () => Promise.resolve(), onChange: () => () => {}, offChange: () => {}, getSelected: () => null, getRegionParam: () => '' };
-  ctx.onWS = () => {};
-  ctx.offWS = () => {};
-  ctx.debouncedOnWS = () => () => {};
-  ctx.invalidateApiCache = () => {};
-  ctx.favStar = () => '';
-  ctx.bindFavStars = () => {};
-  ctx.getFavorites = () => [];
-  ctx.isFavorite = () => false;
-  ctx.connectWS = () => {};
-  ctx.HopResolver = { init: () => {}, resolve: () => ({}), ready: () => false };
-  ctx.initTabBar = () => {};
-  ctx.debounce = (fn) => fn;
-  ctx.copyToClipboard = () => {};
-  ctx.api = () => Promise.resolve({});
-  ctx.escapeHtml = (s) => s;
-  ctx.timeAgo = () => '';
-  ctx.formatTimestampWithTooltip = () => '';
-  ctx.getTimestampMode = () => 'ago';
-  ctx.CLIENT_TTL = {};
-  ctx.qrcode = null;
-
-  try {
-    const src = fs.readFileSync('public/nodes.js', 'utf8');
-    vm.runInContext(src, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-  } catch (e) {
-    console.log('  ⚠️ nodes.js sandbox load failed:', e.message.slice(0, 120));
-  }
-
-  const buildNodesQuery = ctx.buildNodesQuery;
-
-  if (buildNodesQuery) {
-    test('buildNodesQuery: all tab + no search = empty', () => {
-      assert.strictEqual(buildNodesQuery('all', ''), '');
-    });
-    test('buildNodesQuery: repeater tab only', () => {
-      assert.strictEqual(buildNodesQuery('repeater', ''), '?tab=repeater');
-    });
-    test('buildNodesQuery: search only (all tab)', () => {
-      assert.strictEqual(buildNodesQuery('all', 'foo'), '?search=foo');
-    });
-    test('buildNodesQuery: tab + search combined', () => {
-      assert.strictEqual(buildNodesQuery('companion', 'bar'), '?tab=companion&search=bar');
-    });
-    test('buildNodesQuery: null search treated as empty', () => {
-      assert.strictEqual(buildNodesQuery('all', null), '');
-    });
-    test('buildNodesQuery: sensor tab', () => {
-      assert.strictEqual(buildNodesQuery('sensor', ''), '?tab=sensor');
-    });
-  } else {
-    console.log('  ⚠️ buildNodesQuery not exposed — skipping');
-  }
-}
-
-// ===== PACKETS.JS: buildPacketsQuery =====
-console.log('\n=== packets.js: buildPacketsQuery ===');
-{
-  const ctx = makeSandbox();
-  loadInCtx(ctx, 'public/roles.js');
-  loadInCtx(ctx, 'public/app.js');
-
-  ctx.registerPage = () => {};
-  ctx.RegionFilter = { init: () => Promise.resolve(), onChange: () => () => {}, offChange: () => {}, getSelected: () => null, getRegionParam: () => '', setSelected: () => {} };
-  ctx.onWS = () => {};
-  ctx.offWS = () => {};
-  ctx.debouncedOnWS = () => () => {};
-  ctx.invalidateApiCache = () => {};
-  ctx.api = () => Promise.resolve({});
-  ctx.observerMap = new Map();
-  ctx.getParsedPath = () => [];
-  ctx.getParsedDecoded = () => ({});
-  ctx.clearParsedCache = () => {};
-  ctx.escapeHtml = (s) => s;
-  ctx.timeAgo = () => '';
-  ctx.formatTimestampWithTooltip = () => '';
-  ctx.getTimestampMode = () => 'ago';
-  ctx.copyToClipboard = () => {};
-  ctx.CLIENT_TTL = {};
-  ctx.debounce = (fn) => fn;
-  ctx.initTabBar = () => {};
-
-  try {
-    const src = fs.readFileSync('public/packet-helpers.js', 'utf8');
-    vm.runInContext(src, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-    const src2 = fs.readFileSync('public/packets.js', 'utf8');
-    vm.runInContext(src2, ctx);
-    for (const k of Object.keys(ctx.window)) ctx[k] = ctx.window[k];
-  } catch (e) {
-    console.log('  ⚠️ packets.js sandbox load failed:', e.message.slice(0, 120));
-  }
-
-  const buildPacketsQuery = ctx.buildPacketsQuery;
-
-  if (buildPacketsQuery) {
-    test('buildPacketsQuery: default (15min, no region) = empty string', () => {
-      assert.strictEqual(buildPacketsQuery(15, ''), '');
-    });
-    test('buildPacketsQuery: non-default timeWindow', () => {
-      assert.strictEqual(buildPacketsQuery(60, ''), '?timeWindow=60');
-    });
-    test('buildPacketsQuery: region only', () => {
-      assert.strictEqual(buildPacketsQuery(15, 'US-SFO'), '?region=US-SFO');
-    });
-    test('buildPacketsQuery: timeWindow + region', () => {
-      assert.strictEqual(buildPacketsQuery(30, 'US-SFO,US-LAX'), '?timeWindow=30&region=US-SFO%2CUS-LAX');
-    });
-    test('buildPacketsQuery: timeWindow=0 treated as default', () => {
-      assert.strictEqual(buildPacketsQuery(0, ''), '');
-    });
-  } else {
-    console.log('  ⚠️ buildPacketsQuery not exposed — skipping');
-  }
-}
-
-// ===== APP.JS: formatDistance / getDistanceUnit =====
-console.log('\n=== app.js: formatDistance ===');
-{
-  function makeDistCtx(localeLang, storageUnit) {
-    const ctx = makeSandbox();
-    if (storageUnit !== undefined) ctx.localStorage.setItem('meshcore-distance-unit', storageUnit);
-    ctx.navigator = { language: localeLang || 'en-BE' };
-    loadInCtx(ctx, 'public/roles.js');
-    loadInCtx(ctx, 'public/app.js');
-    return ctx;
-  }
-
-  test('formatDistance: km mode, 12.3 km', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance(12.3), '12.3 km');
-  });
-  test('formatDistance: km mode, sub-1km shows meters', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance(0.45), '450 m');
-  });
-  test('formatDistance: mi mode, 12.3 km → 7.6 mi', () => {
-    const ctx = makeDistCtx('en-BE', 'mi');
-    assert.strictEqual(ctx.formatDistance(12.3), '7.6 mi');
-  });
-  test('formatDistance: auto + en-US locale → mi', () => {
-    const ctx = makeDistCtx('en-US', 'auto');
-    assert.strictEqual(ctx.getDistanceUnit(), 'mi');
-  });
-  test('formatDistance: auto + en-GB locale → mi', () => {
-    const ctx = makeDistCtx('en-GB', 'auto');
-    assert.strictEqual(ctx.getDistanceUnit(), 'mi');
-  });
-  test('formatDistance: auto + fr-BE locale → km', () => {
-    const ctx = makeDistCtx('fr-BE', 'auto');
-    assert.strictEqual(ctx.getDistanceUnit(), 'km');
-  });
-  test('formatDistance: null input returns —', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance(null), '—');
-  });
-  test('formatDistanceRound: 50 km → "50 km"', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistanceRound(50), '50 km');
-  });
-  test('formatDistanceRound: 50 km in mi mode → "31 mi"', () => {
-    const ctx = makeDistCtx('en-BE', 'mi');
-    assert.strictEqual(ctx.formatDistanceRound(50), '31 mi');
-  });
-  test('formatDistanceRound: 200 km in mi mode → "124 mi"', () => {
-    const ctx = makeDistCtx('en-BE', 'mi');
-    assert.strictEqual(ctx.formatDistanceRound(200), '124 mi');
-  });
-  test('formatDistance: 0 in km mode → "0 m"', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance(0), '0 m');
-  });
-  test('formatDistance: 0 in mi mode → "0 ft"', () => {
-    const ctx = makeDistCtx('en-BE', 'mi');
-    assert.strictEqual(ctx.formatDistance(0), '0 ft');
-  });
-  test('formatDistance: NaN input returns —', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance(NaN), '—');
-  });
-  test('formatDistance: "abc" input returns —', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistance('abc'), '—');
-  });
-  test('formatDistanceRound: null input returns —', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistanceRound(null), '—');
-  });
-  test('formatDistanceRound: NaN input returns —', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistanceRound(NaN), '—');
-  });
-  test('formatDistanceRound: 0 in km mode → "0 km"', () => {
-    const ctx = makeDistCtx('en-BE', 'km');
-    assert.strictEqual(ctx.formatDistanceRound(0), '0 km');
-  });
-  test('formatDistance: mi mode sub-0.1mi shows feet', () => {
-    const ctx = makeDistCtx('en-BE', 'mi');
-    assert.strictEqual(ctx.formatDistance(0.01), '33 ft');
-  });
-}
-
 // ===== SUMMARY =====
 Promise.allSettled(pendingTests).then(() => {
   console.log(`\n${'═'.repeat(40)}`);

test-packets.js

@@ -629,19 +629,10 @@ console.log('\n=== packets.js: buildFieldTable ===');
   });
 
   test('buildFieldTable hash_size calculation', () => {
-    // Path byte 0xC0 → bits 7-6 = 3 → hash_size = 4, but hash_count = 0
-    // Since #653: when hashCount == 0, shows "hash_count=0 (direct advert)" instead of hash_size
+    // Path byte 0xC0 → bits 7-6 = 3 → hash_size = 4
     const pkt = { raw_hex: '00C0', route_type: 1, payload_type: 0 };
     const decoded = {};
     const result = api.buildFieldTable(pkt, decoded, [], []);
-    assert(result.includes('hash_count=0 (direct advert)'));
-  });
-
-  test('buildFieldTable hash_size shown when hash_count > 0', () => {
-    // Path byte 0xC1 → bits 7-6 = 3 → hash_size = 4, hash_count = 1
-    const pkt = { raw_hex: '00C1aabbccdd', route_type: 1, payload_type: 0 };
-    const decoded = {};
-    const result = api.buildFieldTable(pkt, decoded, [], []);
     assert(result.includes('hash_size=4'));
   });
 

test-panel-corner.js

@@ -1,334 +0,0 @@
-/**
- * Tests for panel corner positioning (#608 M0)
- * Tests the pure logic functions extracted from live.js
- */
-'use strict';
-
-const assert = require('assert');
-const vm = require('vm');
-const fs = require('fs');
-const path = require('path');
-
-// Minimal DOM/browser stubs
-function createContext() {
-  const storage = {};
-  const elements = {};
-  const listeners = {};
-
-  const mockEl = () => ({
-    style: {}, textContent: '', innerHTML: '',
-    classList: { add(){}, remove(){}, toggle(){}, contains(){ return false; } },
-    appendChild(c){ return c; }, removeChild(){ }, insertBefore(c){ return c; },
-    setAttribute(){}, getAttribute(){ return null; }, removeAttribute(){},
-    addEventListener(){}, removeEventListener(){},
-    querySelector(){ return null; }, querySelectorAll(){ return []; },
-    getBoundingClientRect(){ return {top:0,left:0,right:0,bottom:0,width:0,height:0}; },
-    closest(){ return null; }, matches(){ return false; },
-    children: [], childNodes: [], parentNode: null, parentElement: null,
-    focus(){}, blur(){}, click(){}, scrollTo(){},
-    dataset: {}, offsetWidth: 0, offsetHeight: 0,
-    getContext(){ return { clearRect(){}, fillRect(){}, beginPath(){}, moveTo(){}, lineTo(){}, stroke(){}, fill(){}, arc(){}, save(){}, restore(){}, translate(){}, rotate(){}, scale(){}, drawImage(){}, measureText(){ return {width:0}; }, createLinearGradient(){ return {addColorStop(){}}; }, canvas: {width:0,height:0} }; },
-    width: 0, height: 0,
-  });
-
-  const ctx = {
-    window: {},
-    document: {
-      getElementById: (id) => elements[id] || null,
-      querySelectorAll: (sel) => {
-        const results = [];
-        for (const id in elements) {
-          const el = elements[id];
-          if (el._btns) results.push(...el._btns);
-        }
-        return results;
-      },
-      querySelector: () => null,
-      documentElement: { getAttribute: () => null, style: {} },
-      addEventListener: () => {},
-      createElement: () => mockEl(),
-      createElementNS: () => mockEl(),
-      createTextNode: (t) => ({ textContent: t }),
-      createDocumentFragment: () => ({ appendChild(){}, children: [] }),
-      body: { appendChild(){}, removeChild(){}, style: {}, classList: { add(){}, remove(){} } },
-      head: { appendChild(){} },
-    },
-    localStorage: {
-      getItem: (k) => storage[k] !== undefined ? storage[k] : null,
-      setItem: (k, v) => { storage[k] = String(v); },
-      removeItem: (k) => { delete storage[k]; }
-    },
-    _storage: storage,
-    _elements: elements,
-    _addElement: function(id) {
-      const attrs = {};
-      const btns = [];
-      elements[id] = {
-        setAttribute: (k, v) => { attrs[k] = v; },
-        getAttribute: (k) => attrs[k] || null,
-        querySelector: (sel) => {
-          if (sel === '.panel-corner-btn') return btns[0] || null;
-          return null;
-        },
-        _attrs: attrs,
-        _btns: btns,
-        _addBtn: function(panelId) {
-          const btnAttrs = { 'data-panel': panelId };
-          const btn = {
-            textContent: '',
-            setAttribute: (k, v) => { btnAttrs[k] = v; },
-            getAttribute: (k) => btnAttrs[k] || null,
-            addEventListener: () => {},
-            _attrs: btnAttrs
-          };
-          btns.push(btn);
-          return btn;
-        }
-      };
-      return elements[id];
-    }
-  };
-
-  // Self-references
-  ctx.window = ctx;
-  ctx.self = ctx;
-  return ctx;
-}
-
-function loadLiveModule(ctx) {
-  // Load the REAL live.js in a VM context and return window._panelCorner.
-  // This tests the actual code, not a copy (per AGENTS.md "test the real code, not copies").
-  const src = fs.readFileSync(path.join(__dirname, 'public', 'live.js'), 'utf8');
-
-  // Minimal stubs for live.js dependencies (only what's needed to avoid errors)
-  ctx.registerPage = () => {};
-  ctx.escapeHtml = (s) => String(s || '');
-  ctx.timeAgo = () => '—';
-  ctx.getParsedPath = () => [];
-  ctx.getParsedDecoded = () => ({});
-  ctx.TYPE_COLORS = { ADVERT: '#22c55e', GRP_TXT: '#3b82f6', TXT_MSG: '#f59e0b', ACK: '#6b7280', REQUEST: '#a855f7', RESPONSE: '#06b6d4', TRACE: '#ec4899', PATH: '#14b8a6' };
-  ctx.ROLE_COLORS = {};
-  ctx.ROLE_LABELS = {};
-  ctx.ROLE_STYLE = {};
-  ctx.ROLE_SORT = [];
-  ctx.formatTimestampWithTooltip = () => '';
-  ctx.getTimestampMode = () => 'relative';
-  ctx.console = console;
-  ctx.setTimeout = setTimeout;
-  ctx.clearTimeout = clearTimeout;
-  ctx.setInterval = setInterval;
-  ctx.clearInterval = clearInterval;
-  ctx.requestAnimationFrame = (cb) => setTimeout(cb, 0);
-  ctx.cancelAnimationFrame = clearTimeout;
-  ctx.matchMedia = () => ({ matches: false, addEventListener: () => {} });
-  ctx.navigator = { userAgent: '' };
-  ctx.performance = { now: () => Date.now() };
-  ctx.L = undefined;
-  ctx.MutationObserver = class { observe() {} disconnect() {} };
-  ctx.ResizeObserver = class { observe() {} disconnect() {} };
-  ctx.IntersectionObserver = class { observe() {} disconnect() {} };
-  ctx.Image = class {};
-  ctx.AudioContext = undefined;
-  ctx.HTMLElement = class {};
-  ctx.Event = class {};
-  ctx.fetch = () => Promise.resolve({ ok: true, json: () => Promise.resolve([]) });
-  ctx.Number = Number; ctx.String = String; ctx.Array = Array; ctx.Object = Object;
-  ctx.JSON = JSON; ctx.Math = Math; ctx.Date = Date; ctx.RegExp = RegExp;
-  ctx.Error = Error; ctx.Map = Map; ctx.Set = Set; ctx.WeakMap = WeakMap;
-  ctx.parseInt = parseInt; ctx.parseFloat = parseFloat;
-  ctx.isNaN = isNaN; ctx.isFinite = isFinite;
-  ctx.encodeURIComponent = encodeURIComponent;
-  ctx.decodeURIComponent = decodeURIComponent;
-  ctx.Promise = Promise; ctx.Symbol = Symbol;
-  ctx.queueMicrotask = queueMicrotask;
-
-  // Self-references needed for the IIFE
-  ctx.self = ctx;
-  ctx.globalThis = ctx;
-
-  vm.createContext(ctx);
-  vm.runInContext(src, ctx, { timeout: 3000 });
-  return ctx.window._panelCorner;
-}
-
-// ---- Tests ----
-
-let passed = 0;
-let failed = 0;
-
-function test(name, fn) {
-  try {
-    fn();
-    passed++;
-    console.log('  ✓ ' + name);
-  } catch (e) {
-    failed++;
-    console.log('  ✗ ' + name);
-    console.log('    ' + e.message);
-  }
-}
-
-console.log('\nPanel Corner Positioning Tests (#608 M0)\n');
-
-// --- nextAvailableCorner ---
-console.log('nextAvailableCorner:');
-
-test('returns desired corner when available', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const positions = { liveFeed: 'bl', liveLegend: 'br', liveNodeDetail: 'tr' };
-  assert.strictEqual(pc.nextAvailableCorner('liveFeed', 'tl', positions), 'tl');
-});
-
-test('skips occupied corner', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const positions = { liveFeed: 'bl', liveLegend: 'br', liveNodeDetail: 'tr' };
-  // liveFeed wants 'tr' but liveNodeDetail is there → should get 'br'? No, liveLegend is at br → skip to bl? No liveFeed is at bl → skip to tl
-  assert.strictEqual(pc.nextAvailableCorner('liveFeed', 'tr', positions), 'bl');
-  // Wait — liveFeed IS liveFeed, so bl is not occupied by "another" panel
-  // Actually liveFeed wants tr → tr occupied by nodeDetail → try br → occupied by legend → try bl → that's liveFeed itself (excluded from "occupied") → bl is free
-});
-
-test('skips multiple occupied corners', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const positions = { liveFeed: 'tl', liveLegend: 'tr', liveNodeDetail: 'br' };
-  // liveFeed wants 'tr' → occupied by legend → try 'br' → occupied by nodeDetail → try 'bl' → free
-  assert.strictEqual(pc.nextAvailableCorner('liveFeed', 'tr', positions), 'bl');
-});
-
-test('returns desired when only self occupies it', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const positions = { liveFeed: 'bl', liveLegend: 'br', liveNodeDetail: 'tr' };
-  // liveFeed wants bl — it's "occupied" by liveFeed itself, which is excluded
-  assert.strictEqual(pc.nextAvailableCorner('liveFeed', 'bl', positions), 'bl');
-});
-
-// --- getPanelPositions ---
-console.log('\ngetPanelPositions:');
-
-test('returns defaults when nothing in localStorage', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const pos = pc.getPanelPositions();
-  assert.strictEqual(pos.liveFeed, 'bl');
-  assert.strictEqual(pos.liveLegend, 'br');
-  assert.strictEqual(pos.liveNodeDetail, 'tr');
-});
-
-test('returns saved positions from localStorage', () => {
-  const ctx = createContext();
-  ctx.localStorage.setItem('panel-corner-liveFeed', 'tl');
-  ctx.localStorage.setItem('panel-corner-liveLegend', 'bl');
-  const pc = loadLiveModule(ctx);
-  const pos = pc.getPanelPositions();
-  assert.strictEqual(pos.liveFeed, 'tl');
-  assert.strictEqual(pos.liveLegend, 'bl');
-  assert.strictEqual(pos.liveNodeDetail, 'tr'); // still default
-});
-
-// --- applyPanelPosition ---
-console.log('\napplyPanelPosition:');
-
-test('sets data-position attribute on element', () => {
-  const ctx = createContext();
-  const el = ctx._addElement('liveFeed');
-  el._addBtn('liveFeed');
-  const pc = loadLiveModule(ctx);
-  pc.applyPanelPosition('liveFeed', 'tr');
-  assert.strictEqual(el._attrs['data-position'], 'tr');
-});
-
-test('updates button text and aria-label', () => {
-  const ctx = createContext();
-  const el = ctx._addElement('liveFeed');
-  const btn = el._addBtn('liveFeed');
-  const pc = loadLiveModule(ctx);
-  pc.applyPanelPosition('liveFeed', 'tr');
-  assert.strictEqual(btn.textContent, '↙');
-  assert.ok(btn._attrs['aria-label'].includes('top-right'));
-});
-
-test('handles missing element gracefully', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  // Should not throw
-  pc.applyPanelPosition('nonexistent', 'tl');
-});
-
-// --- onCornerClick ---
-console.log('\nonCornerClick:');
-
-test('cycles from default bl to tl for feed', () => {
-  const ctx = createContext();
-  const el = ctx._addElement('liveFeed');
-  el._addBtn('liveFeed');
-  ctx._addElement('liveLegend');
-  ctx._addElement('liveNodeDetail');
-  ctx._addElement('panelPositionAnnounce');
-  ctx._elements.panelPositionAnnounce.textContent = '';
-  const pc = loadLiveModule(ctx);
-  // Feed defaults to bl, cycle: bl → tl (next in cycle after bl is tl)
-  pc.onCornerClick('liveFeed');
-  assert.strictEqual(ctx._storage['panel-corner-liveFeed'], 'tl');
-  assert.strictEqual(el._attrs['data-position'], 'tl');
-});
-
-test('collision avoidance: skips occupied corner', () => {
-  const ctx = createContext();
-  ctx._addElement('liveFeed');
-  const legendEl = ctx._addElement('liveLegend');
-  legendEl._addBtn('liveLegend');
-  ctx._addElement('liveNodeDetail');
-  ctx._addElement('panelPositionAnnounce');
-  ctx._elements.panelPositionAnnounce.textContent = '';
-  const pc = loadLiveModule(ctx);
-  // Legend defaults to br. Click → next is bl. But bl is occupied by feed → skip to tl
-  pc.onCornerClick('liveLegend');
-  assert.strictEqual(ctx._storage['panel-corner-liveLegend'], 'tl');
-});
-
-// --- resetPanelPositions ---
-console.log('\nresetPanelPositions:');
-
-test('clears localStorage and restores defaults', () => {
-  const ctx = createContext();
-  ctx.localStorage.setItem('panel-corner-liveFeed', 'tr');
-  ctx.localStorage.setItem('panel-corner-liveLegend', 'tl');
-  const feedEl = ctx._addElement('liveFeed');
-  feedEl._addBtn('liveFeed');
-  const legendEl = ctx._addElement('liveLegend');
-  legendEl._addBtn('liveLegend');
-  const detailEl = ctx._addElement('liveNodeDetail');
-  detailEl._addBtn('liveNodeDetail');
-  const pc = loadLiveModule(ctx);
-  pc.resetPanelPositions();
-  assert.strictEqual(ctx._storage['panel-corner-liveFeed'], undefined);
-  assert.strictEqual(feedEl._attrs['data-position'], 'bl');
-  assert.strictEqual(legendEl._attrs['data-position'], 'br');
-  assert.strictEqual(detailEl._attrs['data-position'], 'tr');
-});
-
-// --- Corner cycle order ---
-console.log('\nCorner cycle order:');
-
-test('full cycle: tl → tr → br → bl → tl', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  const cycle = pc.CORNER_CYCLE;
-  assert.strictEqual(cycle.join(','), 'tl,tr,br,bl');
-});
-
-test('defaults match expected panel positions', () => {
-  const ctx = createContext();
-  const pc = loadLiveModule(ctx);
-  assert.strictEqual(pc.PANEL_DEFAULTS.liveFeed, 'bl');
-  assert.strictEqual(pc.PANEL_DEFAULTS.liveLegend, 'br');
-  assert.strictEqual(pc.PANEL_DEFAULTS.liveNodeDetail, 'tr');
-});
-
-// Summary
-console.log('\n' + (passed + failed) + ' tests, ' + passed + ' passed, ' + failed + ' failed\n');
-process.exit(failed > 0 ? 1 : 0);

test-table-sort.js

@@ -1,356 +0,0 @@
-/* test-table-sort.js — Unit tests for TableSort utility */
-'use strict';
-
-const { JSDOM } = require('jsdom');
-const fs = require('fs');
-const path = require('path');
-const assert = require('assert');
-
-let passed = 0;
-let failed = 0;
-
-function test(name, fn) {
-  try {
-    fn();
-    passed++;
-    console.log(`  ✓ ${name}`);
-  } catch (e) {
-    failed++;
-    console.log(`  ✗ ${name}`);
-    console.log(`    ${e.message}`);
-  }
-}
-
-function createDOM(html) {
-  const dom = new JSDOM(`<!DOCTYPE html><html><body>${html}</body></html>`, {
-    url: 'http://localhost',
-    runScripts: 'dangerously'
-  });
-  // Load TableSort into this DOM
-  const script = fs.readFileSync(path.join(__dirname, 'public', 'table-sort.js'), 'utf8');
-  const el = dom.window.document.createElement('script');
-  el.textContent = script;
-  dom.window.document.head.appendChild(el);
-  return dom;
-}
-
-function makeTable(headers, rows) {
-  // headers: [{key, type?, label}], rows: [[value, ...]]
-  let html = '<table id="t"><thead><tr>';
-  for (const h of headers) {
-    html += `<th data-sort-key="${h.key}"${h.type ? ` data-type="${h.type}"` : ''}>${h.label || h.key}</th>`;
-  }
-  html += '</tr></thead><tbody>';
-  for (const row of rows) {
-    html += '<tr>';
-    for (let i = 0; i < row.length; i++) {
-      const val = row[i];
-      if (typeof val === 'object' && val !== null) {
-        html += `<td data-value="${val.dataValue}">${val.text || ''}</td>`;
-      } else {
-        html += `<td data-value="${val}">${val}</td>`;
-      }
-    }
-    html += '</tr>';
-  }
-  html += '</tbody></table>';
-  return html;
-}
-
-function getColumnValues(dom, colIndex) {
-  const rows = dom.window.document.querySelectorAll('tbody tr');
-  return Array.from(rows).map(r => r.cells[colIndex].getAttribute('data-value'));
-}
-
-console.log('\nTableSort — comparators');
-
-test('text comparator: basic alphabetical', () => {
-  const cmp = (() => {
-    const dom = createDOM('<div></div>');
-    return dom.window.TableSort.comparators.text;
-  })();
-  assert.ok(cmp('apple', 'banana') < 0);
-  assert.ok(cmp('banana', 'apple') > 0);
-  assert.strictEqual(cmp('same', 'same'), 0);
-});
-
-test('text comparator: null/undefined handling', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.text;
-  assert.strictEqual(cmp(null, null), 0);
-  assert.strictEqual(cmp(undefined, undefined), 0);
-});
-
-test('numeric comparator: basic numbers', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.numeric;
-  assert.ok(cmp('1', '2') < 0);
-  assert.ok(cmp('10', '2') > 0);
-  assert.strictEqual(cmp('5', '5'), 0);
-});
-
-test('numeric comparator: NaN sorts last', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.numeric;
-  assert.ok(cmp('abc', '5') > 0);  // NaN > number (sorts last)
-  assert.ok(cmp('5', 'abc') < 0);
-  assert.strictEqual(cmp('abc', 'xyz'), 0); // both NaN
-});
-
-test('numeric comparator: negative numbers', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.numeric;
-  assert.ok(cmp('-10', '-5') < 0);
-  assert.ok(cmp('-5', '-10') > 0);
-});
-
-test('date comparator: ISO dates', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.date;
-  assert.ok(cmp('2024-01-01T00:00:00Z', '2024-06-01T00:00:00Z') < 0);
-  assert.ok(cmp('2024-06-01T00:00:00Z', '2024-01-01T00:00:00Z') > 0);
-  assert.strictEqual(cmp('2024-01-01', '2024-01-01'), 0);
-});
-
-test('date comparator: invalid dates sort last', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.date;
-  assert.ok(cmp('invalid', '2024-01-01') > 0);
-  assert.ok(cmp('2024-01-01', 'invalid') < 0);
-});
-
-test('dBm comparator: strips suffix', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.dbm;
-  assert.ok(cmp('-120 dBm', '-80 dBm') < 0);
-  assert.ok(cmp('-80 dBm', '-120 dBm') > 0);
-  assert.strictEqual(cmp('-95 dBm', '-95 dBm'), 0);
-});
-
-test('dBm comparator: works without suffix', () => {
-  const dom = createDOM('<div></div>');
-  const cmp = dom.window.TableSort.comparators.dbm;
-  assert.ok(cmp('-120', '-80') < 0);
-});
-
-console.log('\nTableSort — DOM sorting');
-
-test('sort ascending by text column', () => {
-  const html = makeTable(
-    [{key: 'name'}],
-    [['Charlie'], ['Alice'], ['Bob']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  const inst = dom.window.TableSort.init(table, { defaultColumn: 'name', defaultDirection: 'asc' });
-  const vals = getColumnValues(dom, 0);
-  assert.deepStrictEqual(vals, ['Alice', 'Bob', 'Charlie']);
-});
-
-test('sort descending by numeric column', () => {
-  const html = makeTable(
-    [{key: 'val', type: 'numeric'}],
-    [['3'], ['1'], ['2']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'val', defaultDirection: 'desc' });
-  const vals = getColumnValues(dom, 0);
-  assert.deepStrictEqual(vals, ['3', '2', '1']);
-});
-
-test('click toggles direction', () => {
-  const html = makeTable(
-    [{key: 'name'}],
-    [['B'], ['A'], ['C']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  const inst = dom.window.TableSort.init(table, { defaultColumn: 'name', defaultDirection: 'asc' });
-
-  // Initially ascending
-  assert.deepStrictEqual(getColumnValues(dom, 0), ['A', 'B', 'C']);
-
-  // Click same header → descending
-  const th = dom.window.document.querySelector('th[data-sort-key="name"]');
-  th.click();
-  assert.deepStrictEqual(getColumnValues(dom, 0), ['C', 'B', 'A']);
-
-  // Click again → ascending
-  th.click();
-  assert.deepStrictEqual(getColumnValues(dom, 0), ['A', 'B', 'C']);
-});
-
-console.log('\nTableSort — aria-sort attributes');
-
-test('aria-sort set correctly on active column', () => {
-  const html = makeTable(
-    [{key: 'a'}, {key: 'b'}],
-    [['1', 'x'], ['2', 'y']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  const thA = dom.window.document.querySelector('th[data-sort-key="a"]');
-  const thB = dom.window.document.querySelector('th[data-sort-key="b"]');
-  assert.strictEqual(thA.getAttribute('aria-sort'), 'ascending');
-  assert.strictEqual(thB.getAttribute('aria-sort'), 'none');
-});
-
-test('aria-sort updates on direction change', () => {
-  const html = makeTable(
-    [{key: 'a'}],
-    [['1'], ['2']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  const th = dom.window.document.querySelector('th[data-sort-key="a"]');
-  assert.strictEqual(th.getAttribute('aria-sort'), 'ascending');
-
-  th.click(); // toggle to desc
-  assert.strictEqual(th.getAttribute('aria-sort'), 'descending');
-});
-
-test('aria-sort updates when switching columns', () => {
-  const html = makeTable(
-    [{key: 'a'}, {key: 'b'}],
-    [['1', 'x'], ['2', 'y']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  const thB = dom.window.document.querySelector('th[data-sort-key="b"]');
-  thB.click(); // switch to column b
-
-  const thA = dom.window.document.querySelector('th[data-sort-key="a"]');
-  assert.strictEqual(thA.getAttribute('aria-sort'), 'none');
-  assert.strictEqual(thB.getAttribute('aria-sort'), 'ascending');
-});
-
-console.log('\nTableSort — visual indicator');
-
-test('sort arrow shows on active column', () => {
-  const html = makeTable(
-    [{key: 'a'}],
-    [['1'], ['2']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  const arrow = dom.window.document.querySelector('.sort-arrow');
-  assert.ok(arrow, 'sort arrow should exist');
-  assert.ok(arrow.textContent.includes('▲'), 'ascending should show ▲');
-});
-
-test('sort arrow changes on direction toggle', () => {
-  const html = makeTable(
-    [{key: 'a'}],
-    [['1'], ['2']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  const th = dom.window.document.querySelector('th[data-sort-key="a"]');
-  th.click(); // desc
-  const arrow = dom.window.document.querySelector('.sort-arrow');
-  assert.ok(arrow.textContent.includes('▼'), 'descending should show ▼');
-});
-
-console.log('\nTableSort — onSort callback');
-
-test('onSort fires with column and direction', () => {
-  const html = makeTable(
-    [{key: 'a'}, {key: 'b'}],
-    [['1', 'x'], ['2', 'y']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  let called = null;
-  dom.window.TableSort.init(table, {
-    domReorder: false,
-    onSort: function(col, dir) { called = { col, dir }; }
-  });
-
-  const th = dom.window.document.querySelector('th[data-sort-key="a"]');
-  th.click();
-  assert.ok(called, 'onSort should fire');
-  assert.strictEqual(called.col, 'a');
-  assert.strictEqual(called.dir, 'asc');
-});
-
-console.log('\nTableSort — domReorder: false');
-
-test('domReorder: false skips DOM sorting', () => {
-  const html = makeTable(
-    [{key: 'name'}],
-    [['C'], ['A'], ['B']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'name', defaultDirection: 'asc', domReorder: false });
-
-  // DOM order should NOT change
-  const vals = getColumnValues(dom, 0);
-  assert.deepStrictEqual(vals, ['C', 'A', 'B']);
-});
-
-console.log('\nTableSort — destroy');
-
-test('destroy removes event handlers and cleans up', () => {
-  const html = makeTable(
-    [{key: 'a'}],
-    [['2'], ['1']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  const inst = dom.window.TableSort.init(table, { defaultColumn: 'a', defaultDirection: 'asc' });
-
-  inst.destroy();
-
-  const th = dom.window.document.querySelector('th[data-sort-key="a"]');
-  assert.strictEqual(th.getAttribute('aria-sort'), null, 'aria-sort should be removed');
-  assert.ok(!th.classList.contains('sort-active'), 'sort-active should be removed');
-  assert.strictEqual(th.querySelector('.sort-arrow'), null, 'arrow should be removed');
-});
-
-console.log('\nTableSort — custom comparators');
-
-test('custom comparator overrides built-in', () => {
-  const html = makeTable(
-    [{key: 'val', type: 'numeric'}],
-    [['3'], ['1'], ['2']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  // Custom: reverse numeric
-  dom.window.TableSort.init(table, {
-    defaultColumn: 'val', defaultDirection: 'asc',
-    comparators: { val: function(a, b) { return Number(b) - Number(a); } }
-  });
-  const vals = getColumnValues(dom, 0);
-  assert.deepStrictEqual(vals, ['3', '2', '1']); // reversed
-});
-
-console.log('\nTableSort — date sort with data-type="date"');
-
-test('date column sorts correctly', () => {
-  const html = makeTable(
-    [{key: 'ts', type: 'date'}],
-    [['2024-06-15T10:00:00Z'], ['2024-01-01T00:00:00Z'], ['2024-12-25T23:59:59Z']]
-  );
-  const dom = createDOM(html);
-  const table = dom.window.document.getElementById('t');
-  dom.window.TableSort.init(table, { defaultColumn: 'ts', defaultDirection: 'asc' });
-  const vals = getColumnValues(dom, 0);
-  assert.deepStrictEqual(vals, ['2024-01-01T00:00:00Z', '2024-06-15T10:00:00Z', '2024-12-25T23:59:59Z']);
-});
-
-// Summary
-console.log(`\n${passed + failed} tests, ${passed} passed, ${failed} failed\n`);
-process.exit(failed > 0 ? 1 : 0);