# Version Defaults

`version.defaults` sets shared policy for managed versions. Track defaults, entry fields, and group policies can override these values.

## Configuration

**File:** `atmos.yaml`

```yaml
version:
  defaults:
    update:
      strategy: patch
      cooldown: 14d
    include:
      - "v1.*"
    exclude:
      - "*-rc*"
      - "*-beta*"
    prerelease: false
    labels:
      - dependencies
```

## Fields

- **`update.strategy`** — Maximum update scope: `major`, `minor`, `patch`, or `pin`.
- **`update.cooldown`** — Minimum release age before an update is eligible, such as `14d`, `2w`, or `36h`.
- **`update.pin`** — Artifact form to render. Use `digest` or `sha` for immutable identifiers, or `none` for plain versions.
- **`include`** — Candidate version patterns to allow. When set, versions must match at least one pattern.
- **`exclude`** — Candidate version patterns to block. Excluded versions cannot be selected, even when requested directly.
- **`prerelease`** — Whether prerelease candidates are eligible. Defaults to `false`.
- **`labels`** — Metadata labels for downstream workflows and reports.

## Example

```yaml
version:
  defaults:
    update:
      strategy: minor
      cooldown: 7d
    exclude:
      - "*-alpha*"
    prerelease: false
```