felhom-agent/REPORT.md

REPORT — 2026-10-24 (attended release run): agent 0.164.0 — the weekly upload line test (R-1247)

What: the operator's line-measure ruling (2026-10-24 07:26): once a week the host measures its upload line with a 10-second iperf3 upload to ep0's tunnel-only server. The agent speaks iperf3 itself (the operator's pick — no host has the program). Design read: felhom.eu 06 §4.5/§5 (the tunnel, the endpoint), 08 §9 (the watch that uses the line).

Built (f7e1dcb, CI 2277 green)

• internal/linetest: Client (the iperf3 3.x client protocol; the value is the SERVER's received bytes) and Tester (Tuesday 10:00–15:59 local from a per-host slot; a never-measured host is due at once inside the window; 10 quiet minutes of the physical uplink; the one-heavy-op gate; best of 3; busy → later the same day, ≤ 6 tries/day; no tunnel → no test). line_test report stanza; GET /host/line-test; wgtunnel.Manager.LineTestTarget; line_test.disable.
• 15 tests, each red-proved by a mutation (listed in the CHANGELOG entry).

Released and delivered

release-agent.sh 0.164.0 from a fresh clone: tag v0.164.0, sha256 1b803d8b…, bundle 1d7b54d3…, verified by download. One signed agent_update per test box → COMPLETED, self-check 76/76, committed (07:33Z demo-hp, 07:34Z Tester 1, 07:40Z demo-felhom). Vouched by the operator (read back: the hub page and the hub's Artifact manifest set line).

Proven live

A probe built from this package on demo-hp's host: 90.7 Mbit/s in 10.4 s; a second test 2 s later → „server busy" in 0.1 s, the first undisturbed. ep0's port answers only in the tunnel. The boxes' own first tests follow the window.

Open

R-1250 — a qBittorrent that seeds all day keeps the uplink from being quiet, so that host is never tested.