# Changelog 2026-07-12 -- DOCFIX-184: opnsense-prep-image.sh bz2 python fallback

**Context.** First real run of `scripts/opnsense-prep-image.sh` (preparing the OPNsense
26.1 nano image for the Office1 edge) failed exit 2 -- `bunzip2` absent (the nano image
is `.img.bz2`). `bzip2` is not installed and would need sudo.

## Fix
- `scripts/opnsense-prep-image.sh`: the bz2 decompress now prefers `bunzip2` but falls
  back to **python3's stdlib `bz2` module** (python3 is a base prereq on this platform),
  so a missing `bzip2` package is no longer a blocker. The required-tools check requires
  `qemu-img` + (`bunzip2` OR `python3`).

## Verification
- Re-ran the prep: downloaded/decompressed/converted/grew the 26.1 nano image to
  `opnsense-26.1-nano.qcow2` (qcow2, 11 GiB virtual) via the python path.
- `bash tests/opnsense-prep-image/run-tests.sh` -> ALL PASS (3/3). `repo-lint` 0 fail.

## Revert
- `git checkout scripts/opnsense-prep-image.sh`; `git rm` this changelog.