sandogasa-pkg-health - Man Page

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

List registered health checks and their cost tiers

-h, --help

Print help

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

-i, --inventory <PATH>

Path to inventory TOML file (default: 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 (CentOS Stream 9 ships rust-srpm-macros as its own package; rawhide has it in cargo-rpm-macros)

--graph <PATH>

A dependency graph saved by `poi-tracker deps --graph` (repeatable); with one, each package's dependencies are checked too and dependency_health is computed

--dependency-depth <N> [default: 1]

How many levels of dependencies to walk for dependency_health: 1 is the direct ones. Through build dependencies nearly every package reaches the whole toolchain within a few levels

-o, --output <PATH>

Path to report TOML file (read if exists, written after run)

--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

--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

--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 [--package] [--json] [-h|--help] <REPORT>

Display a previously-generated health report without re-running any checks

--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