Skip to content

v2.1.0 - The Ownership Release

Choose a tag to compare

@gmelli gmelli released this 29 Sep 03:46
· 219 commits to main since this release

AGET v2.1.0 - The Ownership Release 🚀

Production Ready | Migration Path Available | Battle-Tested

🎉 Highlights

AGET v2.1 introduces GitFlow-Lite workflow, file ownership patterns, and framework tool separation - making AGET more maintainable, safer, and easier to evolve.

🚀 Major Features

1. GitFlow-Lite Implementation

  • Branch Strategy: main (stable) → develop (active) → release/* (staging)
  • Version Immutability: Tagged releases frozen in dedicated directories
  • Safe Evolution: All changes go through develop branch first

2. File Ownership via aget_ Prefix

  • Clear Boundaries: Framework files prefixed with aget_
  • Conflict Prevention: User files never collide with framework files
  • Easy Identification: Visual distinction in file listings
  • Migration Support: Automated renaming via migration script

3. Documentation Reorganization

  • 19 documents moved to docs/ directory
  • Cleaner root: Only essential files at project root
  • Better discovery: All documentation in one place

4. Automated Quality Systems

  • Hygiene checker for release cleanliness
  • Pre-release validation suite
  • Permission checker for file consistency
  • Migration automation for v2.0 users

📊 By The Numbers

  • 267 tests - All passing
  • 35+ patterns - Ready for installation
  • 9 production agents - Successfully migrated
  • 100% success rate - Zero rollbacks

🔄 Migration from v2.0

Automated Migration (Recommended)

# Download the migration script
curl -O https://raw.githubusercontent.com/gmelli/aget-cli-agent-template/v2.1.0/scripts/migrations/aget_v20_to_v21_migration.py

# Run from your v2.0 agent directory
python3 aget_v20_to_v21_migration.py

The migration script will:
✅ Backup your project automatically
✅ Rename patterns with aget_ prefix
✅ Move documentation to docs/
✅ Update version to 2.1.0
✅ Preserve your custom code

💥 Breaking Changes

Pattern Naming

  • Before: patterns/session/manager.py
  • After: patterns/session/aget_manager.py

Documentation Location

  • Before: Root directory mixed with docs
  • After: All docs in docs/ directory

🎯 Why Upgrade?

  • Cleaner Structure: Clear separation between framework and user code
  • Safer Updates: No more conflicts with framework files
  • Better Organization: All docs in one place
  • Production Ready: Battle-tested on 9 production agents
  • Future Proof: GitFlow-Lite ensures safe evolution

📚 Documentation

⬇️ Download

  • Migration Script: Attached below as aget_v20_to_v21_migration.py
  • Full Template: Clone from GitHub

🙏 Thanks

To the 9 production agents that battle-tested this release and the marathon session that made it possible!


v2.1.0 - Clear boundaries. Safe evolution. Production ready.