ModelForge/docs/operations/RUNBOOK_STORAGE_LOW.md

Runbook: model storage low

Trigger

STORAGE_LOW fires because usable free bytes after absolute/percentage reserve are below policy or unknown.

Diagnose

Confirm the registered root, observed time, writable status, total/free bytes and reserve. Inspect active artifact locations, acquisition quarantine, rollback retention and migration dependencies. Never treat an unavailable capacity reading as healthy.

Act and recover

Use dependency-aware M12 cleanup planning and explicit confirmation. Never issue ad-hoc recursive deletion or remove retained rollback artifacts. Reclaim only reviewed candidates, then collect a fresh storage snapshot and confirm the alert resolves. Escalate filesystem errors, divergent agent paths or repeated unexplained growth.