refactor(bootstrap): BTreeMap for overrides + simplify review

- Switch overrides from HashMap to BTreeMap — deterministic iteration by
  type, drops the manual sort when logging.
- Rename the flat_map closure's inner `ips` to `addrs` to stop shadowing
  the outer Vec<String>.
- Trim the Suite 8 TEST-NET-1 comment to keep the "why" and drop
  mechanism narration.
- Drop a redundant sleep 1 after wait — wait already blocks on exit.

.gitignore

@@ -1,7 +1,6 @@
 /target
 /build-dir
 CLAUDE.md
-.claude/
 docs/
 site/blog/posts/
 ios/

Cargo.lock

@@ -1547,7 +1547,7 @@ dependencies = [
 
 [[package]]
 name = "numa"
-version = "0.14.2"
+version = "0.14.1"
 dependencies = [
  "arc-swap",
  "axum",
@@ -2130,9 +2130,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-webpki"
-version = "0.103.13"
+version = "0.103.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e"
+checksum = "8279bb85272c9f10811ae6a6c547ff594d6a7f3c6c6b02ee9726d1d0dcfcdd06"
 dependencies = [
  "aws-lc-rs",
  "ring",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "numa"
-version = "0.14.2"
+version = "0.14.1"
 authors = ["razvandimescu <razvan@dimescu.com>"]
 edition = "2021"
 description = "Portable DNS resolver in Rust — .numa local domains, ad blocking, developer overrides, DNS-over-HTTPS"

README.md

@@ -125,10 +125,6 @@ docker run -d --name numa --network host \
 
 Multi-arch: `linux/amd64` and `linux/arm64`.
 
-Turnkey compose recipes:
-- [`packaging/client/`](packaging/client/) — ODoH client mode (anonymous DNS), Numa + starter `numa.toml`.
-- [`packaging/relay/`](packaging/relay/) — public ODoH relay, Numa + Caddy + ACME.
-
 ## How It Compares
 
 | | Pi-hole | AdGuard Home | Unbound | Numa |

numa.toml

@@ -22,7 +22,6 @@ api_port = 5380
 # [upstream]
 # mode = "forward"                              # "forward" (default) — relay to upstream
 #                                               # "recursive" — resolve from root hints (no address needed)
-#                                               # "odoh" — Oblivious DoH (see ODoH block below)
 # address = "9.9.9.9"                           # single upstream (plain UDP)
 # address = ["192.168.1.1", "9.9.9.9:5353"]    # multiple upstreams — SRTT picks fastest
 # address = "https://dns.quad9.net/dns-query"   # DNS-over-HTTPS (encrypted)
@@ -30,29 +29,11 @@ api_port = 5380
 # fallback = ["8.8.8.8", "1.1.1.1"]            # tried only when all primaries fail
 # port = 53                                     # default port for addresses without :port
 # timeout_ms = 3000
-# hedge_ms = 0                                   # request hedging delay (ms). Default: 0 (off).
+# hedge_ms = 10                                  # request hedging delay (ms). After this delay
-#                                                # Set to e.g. 10 to fire a parallel upstream
+#                                                # without a response, fires a parallel request
-#                                                # request after 10ms of silence — rescues packet
+#                                                # to the same upstream. Rescues packet loss (UDP),
-#                                                # loss (UDP), dispatch spikes (DoH), TLS stalls
+#                                                # dispatch spikes (DoH), TLS stalls (DoT).
-#                                                # (DoT). Doubles the upstream query count, so
+#                                                # Set to 0 to disable. Default: 10
-#                                                # leave off for quota'd providers (NextDNS,
-#                                                # Control D).
-
-# ODoH (Oblivious DNS-over-HTTPS, RFC 9230). The relay sees your IP but
-# not the question; the target sees the question but not your IP. Numa
-# refuses same-operator relay+target configs by default (eTLD+1 check).
-# [upstream]
-# mode = "odoh"
-# relay = "https://odoh-relay.numa.rs/proxy"
-# target = "https://odoh.cloudflare-dns.com/dns-query"
-# strict = true                                 # default: refuse to downgrade to `fallback`
-#                                                # on relay failure. Set false to allow a
-#                                                # non-oblivious fallback path.
-# relay_ip = "178.104.229.30"                   # optional: pin IPs so numa doesn't leak the
-# target_ip = "104.16.249.249"                  # relay/target hostnames via the bootstrap
-#                                                # resolver on cold boot when numa is its
-#                                                # own system DNS. See docs/implementation/
-#                                                # bootstrap-resolver.md.
 # root_hints = [                                # only used in recursive mode
 #     "198.41.0.4",      # a.root-servers.net (Verisign)
 #     "199.9.14.201",    # b.root-servers.net (USC-ISI)

packaging/client/README.md

@@ -1,72 +0,0 @@
-# Numa ODoH Client — Docker deploy
-
-Single-container deploy that runs Numa as an ODoH (RFC 9230) client: every
-DNS query routes through an independent relay + target so neither operator
-sees both your IP and your question. See the [ODoH integration doc][odoh]
-for the full protocol and privacy trade-offs.
-
-[odoh]: ../../docs/implementation/odoh-integration.md
-
-## Prerequisites
-
-- Docker + Docker Compose v2.
-- Port 53 (UDP+TCP) free on the host — Numa listens there for DNS
-  clients on your LAN.
-
-## Configure
-
-The shipped `numa.toml` points at Numa's own public relay
-(`odoh-relay.numa.rs`) paired with Cloudflare's ODoH target
-(`odoh.cloudflare-dns.com`). That's two independent operators with
-distinct eTLD+1s — the default configuration passes Numa's same-operator
-check and works out of the box.
-
-To use a different relay or target, edit `numa.toml` and adjust the URLs.
-The `relay` and `target` must resolve to distinct operators or Numa
-refuses to start.
-
-## Deploy
-
-```sh
-docker compose up -d
-docker compose logs -f numa        # watch startup
-```
-
-The first query fires the bootstrap resolver + ODoH config fetch;
-subsequent queries reuse the warm HTTP/2 connection.
-
-## Point your devices at it
-
-Set each device's DNS server to the IP of the Docker host. For a LAN-wide
-rollout, set the DNS server in your router's DHCP config so every device
-picks it up automatically.
-
-Verify a query landed on the ODoH path:
-
-```sh
-dig @<host-ip> example.com
-curl http://<host-ip>:5380/stats | jq '.upstream_transport.odoh'
-```
-
-`upstream_transport.odoh` should increment on each query.
-
-## What this does NOT buy you
-
-ODoH protects the *path*, not the content:
-
-- **The target (Cloudflare here) still sees the question.** It just
-  doesn't know it's you asking. If Cloudflare logs every ODoH query, the
-  query is still visible — it's simply unattributed.
-- **The relay is a trusted party for availability.** A malicious relay
-  can drop or delay queries; it just can't read them.
-- **Traffic analysis defeats small relays.** If you're the only client
-  talking to a relay, timing alone re-identifies you. Shared, busy relays
-  give better anonymity sets.
-
-See the [ODoH integration doc][odoh] for more.
-
-## Relay operator?
-
-If you'd rather run your own relay (same binary, different mode), see
-[`../relay/`](../relay/) — that package spins up a public-facing relay
-with Caddy + ACME in front of it.

packaging/client/docker-compose.yml

@@ -1,15 +0,0 @@
-services:
-  numa:
-    image: ghcr.io/razvandimescu/numa:latest
-    command: ["/etc/numa/numa.toml"]
-    ports:
-      - "53:53/udp"
-      - "53:53/tcp"
-      - "5380:5380/tcp"    # dashboard + REST API
-    volumes:
-      - ./numa.toml:/etc/numa/numa.toml:ro
-      - numa_data:/var/lib/numa
-    restart: unless-stopped
-
-volumes:
-  numa_data:

packaging/client/numa.toml

@@ -1,23 +0,0 @@
-# Numa — ODoH client mode (docker-compose starter).
-# Sends every DNS query through an independent relay + target pair so
-# neither operator sees both your IP and your question. See
-# docs/implementation/odoh-integration.md for the protocol details and
-# packaging/client/README.md for deploy notes.
-
-[server]
-bind_addr = "0.0.0.0:53"
-api_bind_addr = "0.0.0.0"
-data_dir = "/var/lib/numa"
-
-[upstream]
-mode = "odoh"
-# Numa's own relay (Hetzner, systemd + Caddy). Swap to any other public
-# ODoH relay if you'd rather not depend on a single operator; the protocol
-# tolerates it, and Numa refuses same-operator relay+target by default.
-relay = "https://odoh-relay.numa.rs/relay"
-target = "https://odoh.cloudflare-dns.com/dns-query"
-# strict = true (default). Relay failure → SERVFAIL, never silent downgrade.
-
-[blocking]
-enabled = true
-# Default blocklist (Hagezi Pro). Edit the `lists` array to taste.

scripts/serve-site.sh

@@ -1,41 +1,14 @@
 #!/usr/bin/env bash
-# Dev server for site/: regenerates drafts on each MD change, reloads the
-# browser on each rendered HTML/CSS/JS change. Port is the first numeric arg
-# (default 9000); any other args are ignored for back-compat.
-#
-# First run downloads chokidar-cli + browser-sync into the npm cache — slow
-# once, instant after that.
-
 set -euo pipefail
 
-PORT=9000
+PORT="${1:-9000}"
-for arg in "$@"; do
-  if [[ "$arg" =~ ^[0-9]+$ ]]; then
-    PORT="$arg"
-    break
-  fi
-done
 
-command -v npx >/dev/null || { echo "npx not found. Install Node.js: https://nodejs.org" >&2; exit 1; }
+if [[ "${1:-}" == "--drafts" ]] || [[ "${2:-}" == "--drafts" ]]; then
-command -v pandoc >/dev/null || { echo "pandoc not found (required by 'make blog-drafts')." >&2; exit 1; }
+  PORT="${PORT//--drafts/9000}"  # default port if --drafts was first arg
-
-# Initial render so the first page load has everything.
   make blog-drafts
+else
+  make blog
+fi
 
-echo "Serving site at http://localhost:$PORT (drafts included, live reload)"
+echo "Serving site at http://localhost:$PORT"
-
+cd site && python3 -m http.server "$PORT"
-# Kill child processes on exit so re-runs don't leave orphaned watchers.
-trap 'kill $(jobs -p) 2>/dev/null' EXIT INT TERM
-
-# Regenerate HTML when MD sources or the blog template change.
-npx --yes chokidar-cli \
-  "drafts/*.md" "blog/*.md" "site/blog-template.html" \
-  -c "make blog-drafts" &
-
-# Serve + reload on rendered-asset changes.
-cd site && exec npx --yes browser-sync start \
-  --server . \
-  --port "$PORT" \
-  --files "**/*.html,**/*.css,**/*.js" \
-  --no-open \
-  --no-notify

src/config.rs

@@ -451,12 +451,8 @@ fn default_upstream_port() -> u16 {
 fn default_timeout_ms() -> u64 {
     5000
 }
-/// Off by default: hedging fires a second upstream query, which silently
-/// doubles the count at the provider — hurts quota'd DNS (NextDNS, Control
-/// D). Opt in with `hedge_ms = 10` for tail-latency rescue on flaky nets
-/// or handshake-slow DoT.
 fn default_hedge_ms() -> u64 {
-    0
+    10
 }
 
 #[derive(Deserialize)]