# 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

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

```shell
# 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.

```shell
> 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).