sandogasa-pkg-health(1)

💖 sandogasa-pkg-health — the glow-up your packages deserve 💖

okay bestie, so this is a page out of the Sandogasa Manual, and it's literally all about sandogasa-pkg-health. Let me tell you everything ✨

---

🌸 NAME 🌸

sandogasa-pkg-health — audit package health across a sandogasa inventory 🩺

✨ SYNOPSIS ✨

sandogasa-pkg-health [-h|--help] [-V|--version] <subcommands>

🦋 DESCRIPTION 🦋

Audit package health across a sandogasa inventory. That's the whole vibe: you point it at an inventory, it tells you how your packages are doing. self-care for your package set, no cap 💅

🎀 OPTIONS 🎀

• -h, --help — Print help 🫶
• -V, --version — Print version ✨

👑 COMMANDS 👑

🌈 sandogasa-pkg-health checks

sandogasa-pkg-health checks [-h|--help]

List registered health checks and their cost tiers 💖 (yes bestie, checks come in tiers — cheap, medium, expensive — and this is how you meet them all).

• -h, --help — Print help 🫶

---

🔥 sandogasa-pkg-health run

sandogasa-pkg-health run [-i|--inventory] [-w|--workspace] [--branch]
[--graph] [--dependency-depth] [--check] [--cheap] [--medium]
[--expensive] [--all] [--max-age] [--package] [--json]
[--fedora-version] [--epel-version] [-v|--verbose] [-h|--help]
<-o|--output>

Run health checks against an inventory. This is the main character, fr fr 👑

• -i, --inventory <PATH> — Path to inventory TOML file. Default? It's the workspace's owned inventory when -w is given 🗂️
• -w, --workspace <PATH> — A poi-tracker workspace file (kondo.toml). Its owned inventory is the default -i, and the saved graphs of its closures for --branch feed the dependency_health check 🕸️
• --branch <BRANCH> [default: rawhide] — The branch whose closures -w reads graphs from. Graphs of different branches are never merged: a binary's source package differs between them. Case in point: CentOS Stream 9 ships rust-srpm-macros as its own package, while rawhide has it inside cargo-rpm-macros. So yeah, don't mix them 😭
• --graph <PATH> — A dependency graph saved by poi-tracker deps --graph (and yes, it's repeatable). Give it one and each package's dependencies get checked too, plus dependency_health gets computed 💫
• --dependency-depth <N> [default: 1] — How many levels of dependencies to walk for dependency_health. 1 means the direct ones. Fair warning bestie: through build dependencies, nearly every package reaches the whole toolchain within a few levels 🌀
• -o, --output <PATH> — Path to report TOML file. It gets read if it exists, and written after the run 📝 (this one's required, so don't skip it)
• --check <ID> — Run only these checks (repeatable) 🎯
• --cheap — Run all cheap-tier checks 🪙
• --medium — Run all medium-tier checks 🧸
• --expensive — Run all expensive-tier checks 💎
• --all — Run all checks regardless of tier. go big or go home 🌈
• --max-age <DURATION> — Re-run any selected check whose stored result is older than this duration (e.g. "7d", "24h") ⏰
• --package <NAME> — Limit to specific packages (repeatable) 📦
• --json — Output summary as JSON 🔧
• --fedora-version <N> — Fedora version(s) for FTBFS / FTI tracker lookup (CSV or repeated). Rawhide trackers are always included, always 💅
• --epel-version <N> — EPEL version(s) for FTBFS / FTI tracker lookup (CSV or repeated) 🌸
• -v, --verbose — Print progress to stderr 👀
• -h, --help — Print help 🫶

---

🧚 sandogasa-pkg-health show

sandogasa-pkg-health show [--package] [--json] [-h|--help] <REPORT>

Display a previously-generated health report without re-running any checks. Iconic lazy-girl behaviour, and honestly? We respect it 🙈

• --package <NAME> — Limit to specific packages (repeatable) 📦
• --json — Output as JSON instead of human-readable 🔧
• -h, --help — Print help 🫶
• <REPORT> — Path to an existing report TOML file 🗂️

---

reminder bestie: run needs -o|--output, so don't come crying to me when it yells at you 💜

---

okay that's the whole page!! this is Sandogasa 0.27.0, dated 2026-10-21 — so you know exactly which era of slay you're working with. mwah, go audit something 🫶✨💖