provisioning/tools/release/README.md

Release Management Output\n\nPurpose: Release artifacts, version tags, and release notes.\n\n## Contents\n\nThis directory contains outputs and staging for release management operations.\n\n## Release Process\n\nRelease management handles:\n\n1. Version Bumping - Update version numbers across the project\n2. Changelog Generation - Create release notes from git history\n3. Git Tagging - Create git tags for releases\n4. Release Notes - Write comprehensive release documentation\n\n## Release Workflow\n\nPrepare a release:\n\n\njust release-prepare --version 4.0.0 # Prepare new release\njust release-validate # Validate release readiness\n\n\nCreate release artifacts:\n\n\njust release-build # Build final release packages\njust release-tag # Create git tags\n\n\nPublish release:\n\n\njust release-publish # Upload to repositories\n\n\n## Version Management\n\nVersions follow semantic versioning: MAJOR.MINOR.PATCH\n\n- MAJOR - Breaking changes\n- MINOR - New features (backward compatible)\n- PATCH - Bug fixes\n\nExample: 4.2.1 = Major 4, Minor 2, Patch 1\n\n## Release Artifacts\n\nA release includes:\n\n- Version-tagged binaries\n- Changelog with all changes\n- Release notes with highlights\n- Git tags for all milestones\n- Published packages in repositories\n\n## Cleanup\n\nRemove release artifacts:\n\n\njust clean # Clean all build artifacts\n\n\n## Related Directories\n\n- dist/ - Build artifacts that releases are based on\n- package/ - Packages that get versioned and released\n- distribution/ - Distribution that incorporates release versions