# Kitout 2.5.0 Release Notes

Kitout 2.5.0 adds targeted managed Homebrew upgrades, while keeping the stable
`version: 1` config schema from earlier 2.x releases.

## Highlights

- Use `kitout upgrade brew:git` to upgrade one managed Homebrew formula.
- Use `kitout upgrade cask:ghostty` to upgrade one managed Homebrew cask.
- Combine resource IDs, such as `kitout upgrade brew:git cask:ghostty`, when
  you want to upgrade a small explicit set.
- Unknown, unsupported, or `--only`-excluded targets fail before Homebrew
  commands run.
- Status advisories now point at the Kitout-native targeted upgrade command and
  still include the equivalent manual Homebrew command.
- The Homebrew formula template points at the `v2.5.0` release artifacts.

## Targeted Upgrade Workflow

Preview one managed formula upgrade:

```sh
kitout upgrade --dry-run brew:git
```

Upgrade one managed cask:

```sh
kitout upgrade cask:ghostty
```

Upgrade an explicit set:

```sh
kitout upgrade brew:git cask:ghostty
```

Keep using broader upgrade filters when useful:

```sh
kitout upgrade --only brew
kitout upgrade --only cask
```

## Compatibility

- No schema version bump is required; this is an additive `version: 1` release.
- Existing `2.4.0` configs continue to load without required changes.
- `kitout upgrade` still upgrades only managed formulae and casks.
- Homebrew taps remain managed by `kitout apply`, not `kitout upgrade`.
- Missing formulae and casks are skipped by `kitout upgrade` with guidance to
  run `kitout apply` first.
- Status checks and dry-runs still do not change the system.
- Kitout still does not install Homebrew automatically.

## Distribution

The tagged release workflow publishes:

- `kitout_2.5.0_darwin_arm64.tar.gz`
- `kitout_2.5.0_darwin_amd64.tar.gz`
- `kitout_2.5.0_checksums.txt`

Homebrew tap installation should use the checksums from the exact GitHub release
assets.

## Install

```sh
brew tap vwall/kitout
brew install kitout
```