ProxSave v0.15.0
🧪 Installer UX upgrades, optional post install audit, and major testability expansion across restore paths
This release focuses on making installation and upgrades easier to operate while greatly expanding unit test coverage for critical restore workflows. It adds a guided post install audit that can disable unused collectors, improves the TUI wizard when editing existing configs, removes obsolete legacy compatibility layers, and introduces extensive dependency injection hooks so mount guards, firewall, access control, NIC mapping, and PBS staged apply can be tested thoroughly without touching the real system.
-
Installer and wizard improvements
- TUI install wizard can now prefill fields from an existing env template when editing, with tighter validation and preserved delivery preferences for Telegram and Email
- Clearer behavior when a config file already exists, with refined prompts and updated docs for both CLI and TUI flows
- Documentation updates to clarify prompts, cloud guidance, and installer flow details
-
Optional post install audit using dry run
- Added an optional post install audit that runs a proxsave dry run to detect unused BACKUP collectors and offers to disable them
- CLI flow supports per key decisions and writes changes atomically only after explicit confirmation
- TUI flow provides an interactive review UI, with improved logging, result summaries, and error surfacing
- Installer session logs are documented, including where to find them under /tmp
-
Removal of obsolete legacy compatibility
- Removed the ENABLE_GO_BACKUP flag and related dead code and wrappers
- Removed the prefilter manual command and cleaned up associated docs and tests
- Consolidated bundle creation by routing callers to Orchestrator.createBundle and simplified legacy identity and orchestrator helpers
-
Major restore testability and coverage expansion
- Mount guards are now mockable via injectable function variables, enabling extensive unit tests for guard creation, mount detection, bind and remount behavior, unmount flows, fstab fallbacks, and timeout handling
- PBS API apply root privilege checks are now injectable to enable full test coverage of service checks, error paths, and API apply behavior
- Firewall restore flow is now fully mockable with broad new tests covering rollback arming and disarming, markers, prompts, file operations, fallbacks, and error branches
- Access control apply and rollback flows are now mockable, with comprehensive tests for scripts, mounting checks, prompt timeouts, commit and abort paths, and failure handling
- NIC mapping logic now supports a configurable sys class net path for tests, with a large new test suite covering inventory parsing, mapping computation, and repair planning and apply
- PBS staged apply adds hookable functions for all key operations, with two new comprehensive test suites covering parsing, validation, fallbacks, deferral logic, atomic write errors, job and tape apply paths, permission checks, and edge cases
-
Dependencies
- Bumped filippo.io/edwards25519 from 1.1.0 to 1.1.1
Behavior changes to note
- ENABLE_GO_BACKUP support has been removed along with its legacy wrappers
- The prefilter manual command has been removed
Overall: a much smoother install experience, an optional guided audit to keep configs lean, and significantly stronger regression protection for the riskiest restore paths through deep testability improvements.