Skip to content

forge v0.4.0 - Enhanced Documentation & Verbose Support

Choose a tag to compare

View all tags
@jwliles jwliles released this 29 Jul 00:54
· 15 commits to main since this release
v0.4.0
This tag was signed with the committer’s verified signature.
jwliles jwliles
GPG key ID: 9A50E5687F005CF4
Verified
Learn about vigilant mode.
627ff18
This commit was signed with the committer’s verified signature.
jwliles jwliles
GPG key ID: 9A50E5687F005CF4
Verified
Learn about vigilant mode.

What's New in v0.4.0

🚀 New Features

  • Verbose Flag Support: Added -v/--verbose flag for detailed operation logging and debugging
  • Enhanced Documentation: Comprehensive troubleshooting guide and error handling documentation
  • Visual Documentation: Added forge.svg diagram showing the symlink management workflow
  • Improved Link Command: Detailed progress logging with step-by-step file operations
  • New Management Commands: Added unstage and purge commands for better file lifecycle management

📚 Documentation Updates

  • MANUAL.md: Added global flags section and comprehensive troubleshooting guide
  • README.md: Enhanced with error handling, debugging steps, and known limitations
  • Man Page: Updated to August 2025 with current feature set
  • Code Documentation: Improved inline documentation and error messages

🔧 Improvements

  • Better Error Handling: More descriptive error messages with actionable troubleshooting steps
  • Safer File Operations: Enhanced file integrity checking and backup mechanisms
  • Test Coverage: Fixed test suite to match current CLI command structure
  • Code Quality: Applied consistent formatting and fixed trailing whitespace

🛠️ Technical Changes

  • Updated test command from 'add' to 'stage' to match current CLI
  • Enhanced link operation with copy validation and backup handling
  • Improved database operations with batch processing support
  • Better path handling and normalization

📦 Installation

cargo install forge-rs

🔄 Migration Notes

  • BREAKING: Configuration directories changed from .dotforge/ to .forge/
  • Existing users need to manually rename directories or reinitialize
  • Binary name remains forge despite crate name change to forge-rs

🐛 Bug Fixes

  • Fixed formatting issues and trailing whitespace
  • Improved symlink creation reliability
  • Better handling of concurrent operations
  • Enhanced error reporting and exit codes

For detailed changelog, see CHANGELOG.md

📋 Full Changelog

v0.3.2...v0.4.0

Assets 2
Loading