Sbh

SBH — storage pressure specialist

SBH exposes disk-pressure status, ballast, scanning, and recovery commands. This skill gathers evidence and performs at most the explicit action authorized by the caller.

Evidence-first recovery works because disk pressure has cheap reversible remedies and expensive irreversible ones; a factual baseline is what tells them apart before anything is deleted. Order remediation by irreversibility: status and dry runs first, ballast release next, cleanup of unprotected files after that, and emergency deletion last — never skip forward while a more reversible step remains untried.

Named failure mode — wrong-mount relief: reclaiming gigabytes on a filesystem that is not the constrained mount and declaring the pressure resolved.

Anti-pattern: escalating straight to emergency --yes because pressure is critical. Corrective: urgency raises the stakes of an irreversible mistake; it never lowers the authorization bar or the ordering above.

Constraints

• Begin with sbh --json status, sbh check, or a dry run on the exact mount because recovery decisions need a factual baseline.
• Never run clean --yes, emergency --yes, ballast release, tune --apply, unprotect, or service/configuration changes without explicit authority because those operations mutate host state.
• Preserve .git/, open-file, young-file, non-writable-parent, and .sbh-protect vetoes because they prevent unsafe or ineffective cleanup.
• Confirm that ballast or reclaimed bytes affect the constrained mount because free space on another filesystem does not resolve the pressure.
• Run one action once, capture before/after evidence, and stop because the caller owns any further mutation. A negative result is returned to the caller; this skill does not retry or escalate it.

Output

Return mount, free bytes, pressure state, dry-run candidates, authorization used, exact command and exit code, bytes reclaimed, protection vetoes, and checked/not checked surfaces.

Full command documentation: https://github.com/Dicklesworthstone/storage_ballast_helper