Repository navigation
Vanta
NETWATCH 1.3.1 — Venta
NETWATCH 1.3.1 is a stabilization release focused on correctness, security boundaries, predictable state handling, and verifiable Linux network administration workflows.
Highlights
- Strict IPv4 and IPv6 target validation.
- Ownership-marked
NETWATCH_BLOCKandNETWATCH6_BLOCKfirewall chains. - Safe rejection of unrelated pre-existing firewall chains.
- IPv4 rollback after partial firewall failures.
- IPv6 block, unblock, reset, and dry-run support.
- Safer ARP-spoof process tracking and termination.
- State is persisted only after successful control operations.
- Explicit persistence failure handling.
- Machine-readable JSON and CSV output with diagnostics separated from stdout.
- Hardened router SSH validation with explicit host-key verification.
- Automatic self-update remains disabled.
- QoS throttle/unthrottle is explicitly unavailable rather than falsely advertised.
- Command-specific dependency validation.
- Expanded mocked regression coverage for destructive firewall behavior.
- GitHub Actions CI with Bash syntax checks, ShellCheck, validation, output, CLI, firewall, IPv6, and router tests.
Security
This release strengthens the boundaries around privileged network operations.
NETWATCH refuses to modify an unrelated firewall chain, refuses to target the configured gateway, validates privileged inputs before applying network controls, verifies ARP process identity before termination, and requires SSH host-key verification in the router bridge.
No automatic execution of downloaded update code is introduced.
Verification
The release candidate passed:
- Bash syntax validation
- ShellCheck
- Validation tests
- Output tests
- CLI tests
- Firewall tests
- IPv6 tests
- Router tests
All required CI stages completed successfully on commit 4b267796e20c742ac938e07324408b53a9055797.
Compatibility
NETWATCH remains Linux-only.
Throttle and unthrottle remain intentionally unavailable in this release until a safe, ownership-aware QoS implementation is available.
Upgrade
This release supersedes the historical v1.3.0 behavior with the stabilized 1.3.1 implementation.
Recommended tag:
v1.3.1
What's Changed
- Document and preserve Linux scan/ARP blocking behavior by @sudomarc in #5
- feat: add Linux IPv6 control and generic router integration by @sudomarc in #6
- fix: stabilize NETWATCH 1.3.1 by @sudomarc in #7
Full Changelog: v1.3.0...v1.3.1