sbh

# SBH — Storage Ballast Helper Prevents disk-full disasters via ballast files, artifact scanning, and predictive pressure monitoring. Three-pronged: ballast (instant space), scanner (stale artifacts), special locations (/tmp, /dev/shm, swap). ## Quick Check ```bash sbh status # Pressure level + free space sbh status --json | jq '.pressure' # Machine-parseable sbh check --need 5G # "Do I have 5 GB free?" sbh check --predict 30 # "Will I run out in 30 min?" ``` Exit codes: 0 = healthy, 1 = pressure, 2 = error. --- ## Daemon ```bash sbh daemon # Foreground (debugging) systemctl --user start sbh # Systemd user scope sbh install --systemd --user --auto # Install + start (Linux) sbh install --launchd --auto # Install + start (macOS) sbh install --wizard # Guided interactive setup ``` **Signals:** `SIGHUP` = reload config, `SIGUSR1` = force scan now, `SIGTERM` = graceful stop. --- ## Ballast Pre-allocated sacrificial files — released in milliseconds, no scanning needed. ```bash sbh ballast status # Per-volume inventory sbh ballast provision # Create/rebuild pool sbh ballast release 3 # Free 3 files NOW sbh ballast replenish # Rebuild after pressure passes ``` Defaults: 10 x 1 GiB = 10 GiB. Ensure ballast dir is on **same mount** as pressure source. --- ## Scanning & Cleanup ```bash sbh scan /data/projects --top 20 # Rank artifac...