branchyard/RELEASE_v1.2.5.md

branchyard — Your shipyard for parallel development workflows. Maintain your digital yard with clean branches, productive workflows, and AI-era readiness.

# Release v1.2.5

## 🎯 Highlights

This release enhances the worktree removal process with safe branch cleanup options and fixes critical stdin handling issues that were causing terminal hanging.

## ✨ New Features

### Safe Branch Deletion on Remove
- **Interactive prompt**: When removing worktrees, branchyard now asks if you want to delete the associated git branches
- **Defensive default**: The prompt defaults to "No" (y/N) to prevent accidental branch deletion
- **Auto-delete flag**: Added `--delete-branch` flag to skip the prompt for automation scenarios
- **Batch operations**: Branch deletion works seamlessly with multiple worktrees

```bash
# Interactive - prompts for branch deletion
branchyard remove agent-factory
# Prompts: "Also delete the git branches? (y/N):"

# Auto-delete without prompting
branchyard remove agent-factory --delete-branch
```

## 🐛 Bug Fixes

### Fixed Terminal Hanging Issue
- **Problem**: Terminal would hang after creating worktrees and saving sessions, requiring Ctrl+C to exit
- **Root cause**: Stdin iterator wasn't being properly closed after reading user input
- **Solution**: Switched to Bun's built-in `prompt()` function and added proper stdin cleanup

### Fixed Missing Import
- **Problem**: `getLastSession` function was not imported, causing TypeScript errors
- **Solution**: Added missing import to fix session restoration functionality

## 🔧 Technical Improvements

- Improved TypeScript type safety throughout the codebase
- Fixed colorette import to use namespace import pattern
- Added proper type annotations for editor configuration
- Enhanced error handling for unknown editors
- Cleaned up stdin handling in the prompts utility

## 📚 Documentation Updates

- Updated README with new branch deletion examples
- Added `--delete-branch` flag to documentation
- Clarified that the flag auto-deletes without prompting
- Updated help text to reflect all changes

## 💡 Usage Examples

### Remove worktrees with interactive branch deletion:
```bash
branchyard remove feature-x bugfix-y
# Asks: "Also delete the git branches? (y/N):"
```

### Remove worktrees and auto-delete branches:
```bash
branchyard remove feature-x bugfix-y --delete-branch
```

### Check what would be removed (dry-run):
```bash
branchyard remove feature-x --dry-run
```

## 🔄 Upgrade Instructions

```bash
# Global installation
bun update -g branchyard

# Or fresh install
bun install -g branchyard
```

## Compatibility

- Requires Bun v1.0 or higher
- Tested with Bun v1.2.19
- Compatible with all major shells and terminals

## Contributors

- Sivaram P (@SivaramPg)

---

*Your shipyard for parallel development workflows* ⚓