release

Release agentx Go Module

Release a new version of the agentx Go module library.

Process

1. Pre-flight Checks

Verify the repository is ready for release.

# Check current branch is main
git branch --show-current

# Check for uncommitted changes
git status --porcelain

# Ensure we're up to date with remote
git fetch origin
git status -uno

Requirements:

• Must be on main branch
• Working directory must be clean (no uncommitted changes)
• Local branch must be up to date with remote

2. Run Tests and Linting

Ensure all quality checks pass.

# Run full check suite
make check

All tests must pass before proceeding.

3. Determine Version Number

Check the current version and recent changes.

# List existing tags
git tag -l 'v*' | sort -V | tail -5

# View recent commits since last tag
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~20")..HEAD --oneline

Version Guidelines (Semantic Versioning):

• MAJOR (1.0.0): Breaking API changes
• MINOR (0.X.0): New features, backward compatible
• PATCH (0.0.X): Bug fixes, backward compatible

4. Review and Update CHANGELOG.md

Analyze changes since the last release.

# View detailed changes
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~20")..HEAD --pretty=format:"%h %s"

# View files changed
git diff $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~20")..HEAD --stat

Update CHANGELOG.md with:

• New version header with today's date
• Categorize changes under: Added, Changed, Deprecated, Removed, Fixed, Security
• Keep descriptions concise but informative

Example entry:

## [0.3.0] - 2026-02-15

### Added
- New agent support for XYZ coding assistant

### Changed
- Improved detection accuracy for environment variables

### Fixed
- Race condition in hook manager initialization

5. Commit CHANGELOG Updates

git add CHANGELOG.md
git commit -m "chore: prepare release vX.Y.Z"