Commands#
This page lists the commands (generated from the CLI) and what each one prints, plus the exit codes.
| Command | What it does |
|---|---|
rollcall advisories |
Check locked package versions against a saved Packagist security-advisories response. |
rollcall digest |
Print (or write, or send) each opted-in owner's digest of what changed in their apps. |
rollcall drift |
Compare policy.json with a saved endoflife.date v1 product file. |
rollcall owners |
List the scanned apps whose owner is unknown (no owners-file entry, or none confirmed within ROLLCALL_OWNERS_CONFIRM_DAYS); exit 1 when there is one. |
rollcall prune |
Delete snapshots older than the retention window; the newest is never deleted. |
rollcall report |
Print the fleet report from the stored snapshots. |
rollcall scan |
Scan the fleet read-only and store a snapshot. |
rollcall advisories#
Check locked package versions against a saved Packagist security-advisories response.
Usage: rollcall advisories [--today TODAY] [--feed FEED]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--feed=VALUE |
Path to the saved Packagist security-advisories JSON. | |
--silent |
Do not output any message |
rollcall digest#
Print (or write, or send) each opted-in owner's digest of what changed in their apps.
Usage: rollcall digest [--today TODAY] [--owner OWNER] [--format FORMAT] [--out OUT] [--send]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--owner=VALUE |
Only this contact from the owners file. | |
--format=VALUE |
text or json. | text |
--out=VALUE |
Write one text file per digest into this directory instead of printing them. | |
--send |
Mail the digests. Needs ROLLCALL_DIGEST_MAIL_ENABLED=true, ROLLCALL_DIGEST_MAIL_DSN and ROLLCALL_DIGEST_MAIL_FROM. | |
--silent |
Do not output any message |
rollcall drift#
Compare policy.json with a saved endoflife.date v1 product file.
Usage: rollcall drift [--today TODAY] [--feed FEED] [--component COMPONENT]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--feed=VALUE |
Path to the saved endoflife.date JSON. | |
--component=VALUE |
Policy component to compare. | php |
--silent |
Do not output any message |
rollcall owners#
List the scanned apps whose owner is unknown (no owners-file entry, or none confirmed within ROLLCALL_OWNERS_CONFIRM_DAYS); exit 1 when there is one.
Usage: rollcall owners [--today TODAY] [--format FORMAT]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--format=VALUE |
text or json. | text |
--silent |
Do not output any message |
rollcall prune#
Delete snapshots older than the retention window; the newest is never deleted.
Usage: rollcall prune [--today TODAY] [--days DAYS] [--dry-run]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--days=VALUE |
Retention window in days (default: ROLLCALL_RETENTION_DAYS, 90; 0 keeps everything). | |
--dry-run |
List what would be deleted without deleting anything. | |
--silent |
Do not output any message |
rollcall report#
Print the fleet report from the stored snapshots.
Usage: rollcall report [--today TODAY] [--format FORMAT] [--internal]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--format=VALUE |
text, json or prometheus. | text |
--internal |
Include the per-app list. Internal only: do not publish it. | |
--silent |
Do not output any message |
rollcall scan#
Scan the fleet read-only and store a snapshot.
Usage: rollcall scan [--today TODAY] [--prune [PRUNE]]
| Option | Meaning | Default |
|---|---|---|
--today=VALUE |
Override today's date (YYYY-MM-DD). | |
--prune=VALUE |
After saving, delete snapshots older than this many days (default: ROLLCALL_RETENTION_DAYS, 90; 0 keeps everything). | |
--silent |
Do not output any message |
Options every command accepts#
| Option | Meaning | Default |
|---|---|---|
-h, --help |
Display help for the given command. When no command is given display help for the list command | |
-q, --quiet |
Only errors are displayed. All other output is suppressed | |
| `-v | -vv | -vvv, --verbose` |
-V, --version |
Display this application version | |
--ansi |
Force (or disable --no-ansi) ANSI output | |
--no-ansi |
Negate the "--ansi" option | |
-n, --no-interaction |
Do not ask any interactive question |
scanscans once and stores<ROLLCALL_STORE_DIR>/<date>.json. A second scan on the same day replaces it. A gap in one source (a missing report, a bad image tag) becomes a note on that app, and the scan carries on. A refused GitLab token stops the scan loudly instead of producing a flattering partial answer.--prune[=DAYS]deletes snapshots older than that many days after saving (default:ROLLCALL_RETENTION_DAYS, 90; 0 keeps everything).reportprints the latest snapshot against the policy as of today.textis a terminal table,jsonis the machine-readable form,prometheusis the metrics text (refused unlessROLLCALL_METRICS_ENABLED=true).--internaladds the per-app list; keep that output inside the project.driftcomparespolicy.jsonwith a saved endoflife.date v1 product page (for examplehttps://endoflife.date/api/v1/products/php/saved to a file). A difference is a flag for a person to look at; the policy stays the source of truth. Rollcall does not fetch that page itself.advisorieschecks each app's lockedlaravel/frameworkand auth-package versions against a saved Packagist security-advisories response (for examplehttps://packagist.org/api/security-advisories/?packages[]=laravel/frameworksaved to a file). One line per package and version, sorted by package then version: the status (affected,clearorno data), the count and the advisory ids, and how many apps hold that pair. A package with no advisory data printsno data, neversafe: an absent row proves nothing about the package, and a version nobody can parse saysno datatoo. Rollcall does not fetch that page itself; a person saves it and--feedpoints at the file. Output is package names and counts only: no app ids.prunedeletes snapshots older than--days(default:ROLLCALL_RETENTION_DAYS, 90; 0 keeps everything). The newest snapshot is never deleted, even if it is older than the cut-off, so the dashboard always has data.--dry-runlists what would go without deleting anything.
Exit codes: 0 ok, 1 owner unknown (rollcall owners only), 2 tool error (a bad option value, an unreadable
policy, a source that refused). Rollcall does not gate the fleet, so no command exits 1 over what the apps run:
rollcall owners exits 1 while an app's owner is unknown, and that is the register, not the fleet. A misspelled
command or an option the CLI does not know never reaches Rollcall: the console library prints the usage and exits
1.