Changelog

v1.1.0 — March 2026

--dry-run flag on all 7 scripts — preview actions without modifying the system
--help flag on all 7 scripts — display usage information
136 unit tests using bats-core with full mock framework (tests/*.bats)
Docker-based unit test container (tests/Dockerfile.unit) on Arch Linux
Docker-based integration test container (tests/Dockerfile.integration) on Arch Linux with real packages
Consolidated CI workflow (.github/workflows/tests.yml) with ShellCheck, unit tests, and integration tests
Testing section in README, CONTRIBUTING, and scripts overview docs

02-wifi-firmware.sh: replaced glob patterns in backup/restore with find commands for fish shell compatibility
03-optimise.sh: replaced sudo -u "$SUDO_USER" with direct HOME override to avoid hanging AUR helpers
05-mount-vault.sh: added $USER fallback via whoami for environments where $USER is unset (e.g. Docker containers)
tests/integration/run-all.sh: fixed ((PASS++)) arithmetic causing set -e to exit when counter is zero

Initial public release. All scripts field-tested on MacBook Air 2020 (MacBookAir9,1) running CachyOS kernel 6.19.x.

00-setup-vault.sh — first-time LUKS2 encrypted vault setup with interactive size selection
01-thermal-setup.sh — mbpfan installation and fan curve configuration for APP0001:00 ACPI path
02-wifi-firmware.sh — BCM4377b firmware verify, backup, restore, and re-install
03-optimise.sh — Ice Lake kernel params, TLP drop-in, PipeWire T2 audio config, suspend fix service
04-bootloader.sh — Limine management, optional rEFInd install, EFI boot order management
05-mount-vault.sh — unlock and mount LUKS2 code vault
06-unmount-vault.sh — lock and unmount LUKS2 code vault
VitePress documentation site

Replaced all glob patterns (applesmc.*) with find commands for fish shell compatibility
Removed sudo -u AUR helper calls (paru/yay hang when called via sudo -u inside sudo session)
Fan sysfs path now detected dynamically via ACPI path instead of hardcoded applesmc.768
mbpfan config uses coretemp sensors only (applesmc TC* sensors not available via expected path on 6.19.x)