atmos version track status

Show policy-aware lock and update status for each entry in a track.

Status Values

current

The locked version matches the policy-eligible target.

update-available

A policy-eligible update differs from the locked version. update would take it.

newer-available (blocked)

A newer version exists upstream, but policy holds it back. The entry still passes verify.

unlocked

The entry has no lock file record.

locked

The entry is locked, but its target could not be resolved.

Usage

atmos version track status [track] [flags]

Flags

--group

Limit status to entries in the named version group.

--format string

Output format: table, json, yaml, csv, tsv (default: table)

Examples

# Show status for prod
atmos version track status prod

# Show infrastructure group status as JSON
atmos version track status prod --group=infrastructure --format=json

Example Output

In an interactive terminal, --format=table (the default) renders a styled table. Use --format=csv or --format=tsv for delimited output; piped table output remains a table.

> atmos version track status prod --format=csv
Track,Name,Group,Desired,Locked,Resolved,Status,Message
prod,checkout,infrastructure,v6,v6.1.0,v6.2.0,update-available,
prod,nginx,infrastructure,1.x,1.29.0,1.30.0,newer-available (blocked),"1.30.0 released 3d ago; cooldown 14d has not elapsed"

Use --format=yaml or --format=json for the full-fidelity result, including fields the table omits (e.g. ecosystem, datasource, package).