Versioning

The Versioning Engine reads .ags/versioning.yml, maps Commit-Scopes to bump rules, and keeps package versions + changelog aligned with what actually landed.

Config

.ags/versioning.yml yaml

schemaVersion: 1
scheme: semver
packages:
  - name: "@acme/app"
    path: packages/app/package.json
    previousVersion: "1.0.0"
bumpRules:
  file-create: minor
  module-wire: minor
  single-change: patch
  single-fix: patch
  breaking-change: major
  milestone-close: none
changelog:
  path: CHANGELOG.md

scheme: semver — major / minor / patch
packages[] — which package.json files to track
bumpRules — Commit-Scope → bump (or none)
changelog.path — where release notes accumulate

Example mapping

Commit-Scope	Bump	Why
`breaking-change`	major	Contract break
`file-create` / `module-wire`	minor	Additive surface
`single-fix` / `single-change`	patch	Compatible fix / tweak
`milestone-close`	none	Process commit — bump already happened in work commits

Changelog snippet agents produce

## 1.2.0
- feat(auth): session refresh helper (Commit-Scope: function-create)
- fix(auth): clear stale token on 401 (Commit-Scope: single-fix)

Showcase: Versioning. Related: Deployment, Examples.