# Releases and Versioning

## Versioning policy
This project follows Semantic Versioning:
- `MAJOR`: breaking CLI/API/data changes
- `MINOR`: backward-compatible features
- `PATCH`: backward-compatible fixes

Current project version is tracked in [`VERSION`](../VERSION).

## Release process
1. Update `VERSION`.
2. Add new section in `CHANGELOG.md` with date and changes.
3. Run:
   - `go test ./...`
   - `go build -o bin/pxmon ./cmd/pxmon`
   - `go build -o bin/pxmon-agent ./cmd/pxmon-agent`
4. Tag release:
   - `git tag vX.Y.Z`
   - `git push origin vX.Y.Z`

## Versions list
- `v0.2.0` (2026-06-16): RepoTunneling, remote exec, key passphrase files, export/import key-file restore, and release cleanup.
- `v0.1.0` (2026-04-17): initial open-source packaging release.

## Agent versions
Known agent versions are stored in:
- `internal/cluster/agent_versions.json`

This list is used by agent status/drift checks to flag outdated nodes.