Upgrade Notes

Guides for upgrading between major Anvil versions.

Upgrading to 1.0

From 0.9.x

Anvil 1.0 is the first stable release. If you were using the beta:

Configuration Changes

// Old (0.9.x)
{
  "checks": {
    "architecture": { ... }
  }
}

// New (1.0)
{
  "gates": {
    "architecture": { ... }
  }
}

Migration:

# Rename "checks" to "gates" in anvil.config.json

CLI Changes

Old Command	New Command
anvil check	anvil run
anvil check --watch	anvil watch

Evidence Format

Evidence format changed. Old evidence files are not compatible.

Migration:

# Clear old evidence
rm -rf .anvil/evidence

# Run fresh
anvil run

From No Previous Version

If you're new to Anvil, start with:

pnpm add -D @eddacraft/anvil-cli
anvil init
anvil run

Future Versions

This section will be updated with each major release.

Getting Help

If you encounter upgrade issues:

1. Check the Troubleshooting guide
2. Search existing issues
3. Open a new issue with:
   • Old version
   • New version
   • Error message
   • Steps to reproduce