First public release of RouteWitness, a local-first network incident recorder for intermittent connectivity failures.
Highlights:
- bounded before/during/after incident evidence
- gateway, Internet, DNS, service, and path observations
- deterministic evidence-based diagnosis
- offline sanitized HTML, Markdown, CSV, and JSON reports
- foreground watcher with crash-safe checkpoints and process locking
- Windows, Linux, and macOS support on Python 3.11–3.13
- no account, telemetry, cloud backend, automatic upload, or privilege elevation
Validation:
- 78 deterministic/offline tests
- Ruff formatting/lint and strict mypy clean
- 9/9 GitHub Actions jobs green across Windows, Ubuntu, macOS × Python 3.11–3.13
- native Windows foreground validation on Python 3.13.14
- regression fix for false route-change incidents caused by volatile route-table metadata
The attached wheel and source distribution were built from the tagged release candidate and verified by installing the wheel in a clean virtual environment.