poi-tracker - Man Page

Package-of-interest tracker for Fedora, EPEL, and CentOS SIGs

Synopsis

Description

Package-of-interest tracker for Fedora, EPEL, and CentOS SIGs

Options

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help
-V, --version: Print version

poi-tracker act [-i|--inventory] [-I|--inventory-dir] [--pattern] [-C|--directory] [--start-from] [--end-with] [-w|--workspace] [--closure] [--personal] [--branch] [--api-token] [--refresh-acls] [-v|--verbose] [-h|--help] <--user>

Enact the standing cull verdicts interactively: orphan, remove own ACL, or give each package away, adjusting the inventories as you go

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--user <USER>: FAS username whose ACL actions these are
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--personal <PATH>: Personal inventory to drop enacted packages from
--branch <BRANCH> [default: auto]: Branch(es) for the reverse-dependency probe before an orphan (CSV or repeated). The default `auto` derives them per package from its dist-git branches: rawhide plus its own EPEL branches — an EPEL-only package's dependents are invisible from rawhide
--api-token <API_TOKEN>: Dist-git API token (or PAGURE_API_TOKEN, or run `poi-tracker config`)
May also be specified with the PAGURE_API_TOKEN environment variable.
--refresh-acls: Ignore the day-fresh ACL cache and look every level up again
-v, --verbose: Log each access lookup
-h, --help: Print help

poi-tracker add

Add a package to the inventory

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--poc <POC>: Point of contact ("Name <email>")
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--reason <REASON>: Reason for tracking
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--team <TEAM>: Team responsible
--task <TASK>: Internal task/ticket reference
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--rpm <RPM>: Binary RPM subpackage(s) to track (comma-separated or repeated)
--workload <WORKLOAD>: Workload tag(s) (comma-separated or repeated)
--track <TRACK>: Track branch for hs-relmon (e.g. upstream, fedora-rawhide)
-h, --help: Print help
<NAME>: Source RPM name

poi-tracker adopt

Adopt orphaned inventory packages on dist-git

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
--api-token <API_TOKEN>: Dist-git API token with the `modify_project` ACL (or set PAGURE_API_TOKEN, or run `poi-tracker config`)
May also be specified with the PAGURE_API_TOKEN environment variable.
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--dry-run: Preview orphaned packages without adopting them
-y, --yes: Adopt every orphaned match without per-package prompts
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker announce

Render the standing cull verdicts as the grouped, announcement-ready report with runnable ACL commands

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--user <USER>: FAS username whose access level routes each action
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--refresh-acls: Ignore the day-fresh ACL cache and look every level up again
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-v, --verbose: Log each access lookup
--json: Output machine-readable JSON
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker config

Configure poi-tracker (Bugzilla API key, etc.)

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker dependents

Classify inventory packages by who depends on them, over a saved dependency graph: leaves, packages other keeps carry, externally needed ones

--graph <PATH>: Dependency graph JSON from a `deps --graph` run
-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--json: Output machine-readable JSON
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker deps

Inventory the dependencies pulled from other repos (e.g. EPEL)

-i, --inventory <INVENTORY>

Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply

--pattern <GLOB,...>

Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages

-I, --inventory-dir <DIR>

Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which

--start-from <NAME>

Resume from this package onwards (inclusive), in the inventory's iteration order

-C, --directory <DIR>

Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there

--end-with <NAME>

Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range

-b, --branch <BRANCH>

fedrq branch (e.g. hs.el9, epel9)

-w, --workspace <PATH>

Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it

--closure <NAME>

Which [[closure]] of the workspace a walk subcommand works on (default: the first)

-r, --repo <REPO>

fedrq repo class (e.g. stack)

--from <FROM> [default: epel]

Collect providers from these repo ids (CSV or repeated).

Exact match. The default suits an EPEL walk; for a Fedora walk pass the branch's own repo id, e.g. `--from rawhide`.

--base-repo <BASE_REPO> [default: fedrq-centos-stream-]

Base-distro repo id prefix(es); their providers end the walk.

The default treats CentOS Stream as the given beneath an EPEL stack. A Fedora walk has no base distro — the default then never matches, and everything resolves within --from's repos, which is what you want.

--runtime-only

Walk runtime dependencies only, without seeding the roots' BuildRequires

--graph <PATH>

Where to write the walk's full dependency graph (every requirer/provider edge, not just first attributions) as JSON. Default: beside -o, as <output>-graph.json

--fixpoint <PATH>

Iterate to a fixpoint: collected packages found in this inventory (yours) become roots whose BuildRequires seed further rounds

-o, --output <OUTPUT>

Write the collected dependencies as an inventory TOML file

--name <NAME>

Inventory name for --output (default: "<input name>-deps-<branch>")

--json

Output as JSON instead of human-readable

-v, --verbose

Print progress to stderr

-h, --help

Print help (see a summary with '-h')

poi-tracker derive

Recompute a derived dependency inventory offline from a saved graph: owned packages the keeps reach

--graph <PATH>: Dependency graph JSON from a `deps --graph` run
-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--owned <PATH>: Inventory of the packages you own (e.g. a sync-distgit output); only owned packages enter the derived inventory
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-o, --output <PATH>: The derived inventory to recompute
--apply: Replace the output file's packages; without it, report only
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--json: Output machine-readable JSON
-h, --help: Print help

poi-tracker export

Export inventory to another format

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker export content-resolver

Export as content-resolver YAML

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--workload <WORKLOAD>: Export only this workload
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-o, --output <OUTPUT>: Output file (default: {workload-name}.yaml)
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker export hs-relmon

Export as hs-relmon manifest TOML

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--workload <WORKLOAD>: Filter by workload
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-o, --output <OUTPUT>: Output file (default: stdout)
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--distros <DISTROS> [default: upstream,fedora,centos,hyperscale]: Default distros list
--track <TRACK> [default: upstream]: Default tracking branch
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--prune: Remove manifest entries not in the inventory
-h, --help: Print help

poi-tracker find

Find which inventory file(s) contain a package

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help
<NAME>: Source RPM name to search for

poi-tracker import

Import from legacy JSON format

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-o, --output <OUTPUT> [default: inventory.toml]: Output path for TOML inventory
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--private-fields <FIELD,...>: Fields to mark as private (stripped on export)
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--workload <WORKLOAD,...>: Workload tag(s) to apply to all imported packages
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help
<JSON_FILE>: Path to legacy JSON inventory file

poi-tracker intersect

Keep only the inventory packages also present in other inventories, optionally merging them into a file

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--with <WITH>: Inventory file(s) to intersect with: only packages of the main inventory also found in one of these survive (repeat the flag per file)
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-o, --output <OUTPUT>: Merge the intersection into this inventory TOML file (accumulates; existing entries win)
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--json: Output as JSON instead of human-readable
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker keep

Start keeping packages: walk them against the saved graph (fedrq only for what it lacks), merge, recompute the derived inventory

-i, --inventory <INVENTORY>

Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply

--into <PATH>

Keep inventory to add them to (default: the first -i)

--graph <PATH>

Saved dependency graph to extend (from `deps`); the walk resolves offline whatever it already knows

-I, --inventory-dir <DIR>

Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which

-C, --directory <DIR>

Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there

--owned <PATH>

Inventory of the packages you own — newly reached owned packages become fixpoint roots and derived entries

--deps <PATH>

Derived inventory to recompute afterwards (optional)

-w, --workspace <PATH>

--closure <NAME>

Which [[closure]] of the workspace a walk subcommand works on (default: the first)

-o, --output <PATH>

Closure inventory (the `deps -o` file) to bring up to date with the graph afterwards (optional)

-b, --branch <BRANCH>

fedrq branch (e.g. hs.el9, epel9)

-r, --repo <REPO>

fedrq repo class (e.g. stack)

--from <FROM> [default: epel]

Collect providers from these repo ids (CSV or repeated).

Exact match. The default suits an EPEL walk; for a Fedora walk pass the branch's own repo id, e.g. `--from rawhide`.

--base-repo <BASE_REPO> [default: fedrq-centos-stream-]

Base-distro repo id prefix(es); their providers end the walk.

--runtime-only

Walk runtime dependencies only, without seeding the roots' BuildRequires

--json

Output as JSON instead of human-readable

-v, --verbose

Print progress to stderr

-h, --help

Print help (see a summary with '-h')

<PACKAGE>

Packages to start keeping

poi-tracker kondo

Triage packages no essential inventory needs: keep as a cull candidate, file into an inventory, or drop

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
--essential <ESSENTIAL>: Essential inventory file(s): packages found in any of these are never cull candidates (repeat the flag per file)
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--user <USER>: dist-git username whose access level routes each action
--explain-into <PATH>: Default inventory for 'explain': Enter at the explanation prompt files the package here
-y, --yes: Keep every candidate without prompting
--refresh-acls: Ignore the day-fresh ACL cache and look every level up again
--reason <REASON>: Reason recorded in the -o cull file for packages culled this run (the access level is always appended). A note typed at the prompt as `c <note>` overrides it per package
-o, --output <OUTPUT>: Merge the culled set into this inventory TOML file (accumulates across passes)
--json: Output as JSON instead of human-readable
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker prune-retired

Mark (or remove) packages no longer carried on any active branch (dist-git project gone or retired everywhere)

--branch <BRANCH,...>: Active branch(es) to check against (CSV or repeated; e.g. `rawhide,f44,epel9`). Default: queried from Bodhi's active releases, plus rawhide
-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-j, --jobs <JOBS> [default: 8]: Parallel dist-git queries
--dry-run: Preview without modifying the inventory
--remove: Delete matched packages from the inventory instead of marking them `unshipped` (the default; marking survives re-syncs and lets triage-retired keep closing bugs)
-y, --yes: Skip the confirmation prompt
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker reconcile

Bring the workspace's inventories up to date with its keeps: walk new keeps, recompute the derived inventories, ask the decisions a program cannot make, then triage what nothing justifies

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--into <PATH>: Essential inventory that promoted packages are filed into (default: the closure's first keeps inventory)
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-y, --yes: Take every default without asking (ride, keep essential), and leave the triage candidates as cull candidates
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--refresh-acls: Ignore the day-fresh ACL cache in the triage
--dry-run: Compute and report only: write no file, walk nothing, ask nothing (new keeps are listed instead of walked)
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--json: Report as JSON; asks and triages nothing (files are still written unless --dry-run)
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker remove

Remove a package from the inventory

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--rpm <RPM>: Remove specific binary RPM(s) instead of the whole package
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help
<NAME>: Source RPM name to remove

poi-tracker semver-audit

Audit pending upstream updates by semver impact, flagging which are non-breaking, breaking, or need review

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
--batch [<EMAIL>]: Batch mode: one Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the configured email), matched against the inventory locally. Much faster on a large inventory, but misses bugs where EMAIL is neither assignee nor CC'd
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--non-breaking: Show only non-breaking updates
--json: Output as JSON instead of human-readable text
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker show

Show inventory contents

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--workload <WORKLOAD>: Filter by workload
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--json: Output as JSON instead of human-readable
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

poi-tracker sync-distgit

poi-tracker sync-distgit [-i|--inventory] [-I|--inventory-dir] [-C|--directory] [-o|--output] [--fast] [-w|--workspace] [--closure] [--no-groups] [--include-group] [--exclude-group] [--exclude] [--pattern] [--start-pattern] [--end-pattern] [--auto-prefix] [--no-auto-prefix] [--prune] [--mark-unshipped] [-j|--jobs] [--per-page] [--workload] [--name] [-h|--help] <--user|--group>

Sync inventory from Fedora dist-git (Pagure) access

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--user <USER>: Import packages for this dist-git user
--group <GROUP>: Import packages for this dist-git group
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-o, --output <OUTPUT> [default: inventory.toml]: Output TOML file
--fast: One owner-alias request instead of a prefix scan. Direct owner/admin/commit only: collaborator/ticket grants are missed (and removed under --prune). Implies --no-groups
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--no-groups: Exclude group-only access
--include-group <GROUP,...>: Keep only these groups (CSV or repeated)
--exclude-group <GROUP,...>: Drop these groups (CSV or repeated)
--exclude <GLOB,...>: Exclude packages by glob (CSV or repeated)
--pattern <PATTERN>: Name pattern for a single patterned query
--start-pattern <PREFIX>: Start the prefix scan at this prefix
--end-pattern <PREFIX>: Stop the prefix scan before this prefix
--auto-prefix: Query by a-z/0-9 prefix (--user default)
--no-auto-prefix: Single query; may 504 for a --user sync
--prune: Remove packages no longer in dist-git results
--mark-unshipped: Mark packages added by this sync that are already retired everywhere (like prune-retired)
-j, --jobs <JOBS> [default: 8]: Parallel dist-git queries for --mark-unshipped
--per-page <PER_PAGE> [default: 100]: Pagure API page size
--workload <WORKLOAD,...>: Workload tags (CSV or repeated)
--name <NAME>: Inventory name (default: user/group)
-h, --help: Print help

poi-tracker sync-gitlab

Sync inventory from a GitLab RPM group

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--url <URL>: GitLab group URL
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--preset <PRESET>: Preset: hyperscale, proposed-updates, centos-stream
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-o, --output <OUTPUT> [default: inventory.toml]: Output TOML file
--exclude <GLOB,...>: Exclude packages by glob (CSV or repeated)
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--prune: Remove packages no longer in GitLab results
--workload <WORKLOAD,...>: Workload tags (CSV or repeated)
--mark-unshipped: Mark archived projects with no released CBS build as unshipped (Hyperscale: RHEL or Stream; Proposed Updates: Stream only)
--centos-release <REL,...> [default: 9,10]: CentOS releases to count as currently shipped (CSV)
--name <NAME>: Inventory name (default: derived from group)
-h, --help: Print help

poi-tracker triage-retired

poi-tracker triage-retired [--branch] [-i|--inventory] [-I|--inventory-dir] [--pattern] [-C|--directory] [--start-from] [--end-with] [-w|--workspace] [--batch] [--closure] [--all-reporters] [--mark] [--api-key] [--claim] [--dry-run] [-y|--yes] [-v|--verbose] [-h|--help]

Close open release-monitoring bugs as CANTFIX for any inventoried package that is retired on a dist-git branch

--branch <BRANCH,...> [default: rawhide]: Dist-git branch(es) to check retirement against (CSV or repeated; e.g. `rawhide`, `epel10`, `f43`). Each branch scopes its own Bugzilla search — a `rawhide` retirement closes the Fedora/rawhide bug, an `epel9` retirement closes the Fedora EPEL/epel9 bug. A package retired on one branch but live on another only has bugs closed where it's dead
-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--batch [<EMAIL>]: Batch mode: one Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the configured email), matched against the inventory locally. Much faster on a large inventory, but misses bugs where EMAIL is neither assignee nor CC'd
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--all-reporters: Close ALL open bugs on retired branches, not just release-monitoring (Anitya) bugs. Use with care: this closes human-filed bugs (CVEs, FTBFS, etc.) too
--mark: Record results in the inventory's `retired_on` markers (adds and removes; needs a single -i file)
--api-key <API_KEY>: Bugzilla API key (or set BUGZILLA_API_KEY env var, or run `poi-tracker config`)
May also be specified with the BUGZILLA_API_KEY environment variable.
--claim: Also set `assigned_to` on each closed bug to the Bugzilla email set via `poi-tracker config`. Interactive mode prompts; with `-y` this flag is the only way to claim
--dry-run: Preview closures without applying them
-y, --yes: Skip the confirmation prompt
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker triage-updates

poi-tracker triage-updates [-i|--inventory] [--pattern] [-I|--inventory-dir] [--start-from] [-C|--directory] [--end-with] [--batch] [-w|--workspace] [--close-stale] [--closure] [--skip-stale] [--api-key] [--claim] [--dry-run] [-y|--yes] [-v|--verbose] [-h|--help]

Triage open release-monitoring bugs for inventoried packages by bumping their Bugzilla priority to match the inventory

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--pattern <GLOB,...>: Only process packages matching this glob (e.g. `rust-*`; a bare name matches exactly). Comma-separated or repeated; default: all packages
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--start-from <NAME>: Resume from this package onwards (inclusive), in the inventory's iteration order
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--end-with <NAME>: Stop after this package (inclusive). Combine with `--start-from` to bound a sub-range
--batch [<EMAIL>]: Batch mode: one Bugzilla query for bugs assigned to or CC'ing EMAIL (default: the configured email), matched against the inventory locally. Much faster on a large inventory, but misses bugs where EMAIL is neither assignee nor CC'd
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--close-stale: Close partially-addressed bugs without asking
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
--skip-stale: Skip the Bodhi check for already-built updates
--api-key <API_KEY>: Bugzilla API key (or set BUGZILLA_API_KEY env var, or run `poi-tracker config`)
May also be specified with the BUGZILLA_API_KEY environment variable.
--claim: Also set `assigned_to` on each closed bug to the Bugzilla email set via `poi-tracker config`. Interactive mode prompts; with `-y` this flag is the only way to claim
--dry-run: Preview updates without applying them
-y, --yes: Skip the confirmation prompt
-v, --verbose: Print progress to stderr
-h, --help: Print help

poi-tracker unkeep

Stop keeping packages: over a saved dependency graph, report what the removal frees, and optionally edit the inventories

--graph <PATH>: Dependency graph JSON from a `deps --graph` run
-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
--deps <PATH>: Derived dependency inventories (a `deps` output merged by `intersect`, say); freed packages leave these with --apply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
--apply: Edit the inventories; without it, report only
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
--json: Output machine-readable JSON
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help
<PACKAGE>: Packages to stop keeping

poi-tracker validate

Validate inventory consistency

-i, --inventory <INVENTORY>: Exactly these inventory TOML file(s) (repeatable) — the most specific of the three ways to name inventories, and always honoured: it overrides whatever a workspace file would supply
-I, --inventory-dir <DIR>: Every *.toml in DIR as an inventory, roles unknown — for commands that treat inventories alike (show, find, validate, export). Use -i to pick files, or a workspace to say which is which
-C, --directory <DIR>: Run as if started in DIR (like `git -C`): the workspace file, relative inventory paths and outputs are looked up there
-w, --workspace <PATH>: Workspace file (default: ./kondo.toml when present) naming which inventory is which — owned, keeps, derived, retired, cull — plus the graph and walk settings, so each subcommand knows its inputs without -i. Only fills flags not given on the command line; --no-defaults ignores it
--closure <NAME>: Which [[closure]] of the workspace a walk subcommand works on (default: the first)
-h, --help: Print help

Info

2026-09-10 sandogasa 0.24.0 Sandogasa Manual