refactor: simplify to menu-only interface with comprehensive docs and fixes

Author: wasabeef

.git-workers.toml

@@ -0,0 +1,23 @@
+# Git Workers configuration file
+
+[repository]
+# Repository URL for identification (optional)
+# This ensures hooks only run in the intended repository
+url = "https://github.com/wasabeef/git-workers.git"
+
+[hooks]
+# Run after creating a new worktree
+post-create = [
+    "echo '🤖 Created worktree: {{worktree_name}}'",
+    "echo '🤖 Path: {{worktree_path}}'"
+]
+
+# Run before removing a worktree
+pre-remove = [
+    "echo '🤖 Removing worktree: {{worktree_name}}'"
+]
+
+# Run after switching to a worktree
+post-switch = [
+    "echo '🤖 Switched to: {{worktree_name}}'"
+]

CHANGELOG.md

@@ -1,17 +1,86 @@
 # Changelog
 
-Please see [GitHub Releases](https://github.com/wasabeef/git-workers/releases) for the complete changelog.
+All notable changes to Git Workers will be documented in this file.
 
-Each release includes:
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-- Detailed release notes generated from commit history
-- Binary downloads for all supported platforms
-- Installation instructions
+For detailed release notes and binary downloads, see [GitHub Releases](https://github.com/wasabeef/git-workers/releases).
 
-The release notes are automatically generated using conventional commits, categorizing changes into:
+## [Unreleased]
 
-- Features
-- Bug Fixes
-- Documentation
-- Performance improvements
-- And more
+### Changed
+
+- **BREAKING**: Removed command-line argument options (--list, --create, etc.) in favor of interactive menu-only interface
+- Simplified main.rs to focus solely on interactive menu operations
+- Improved worktree rename functionality with `git worktree repair` integration
+- Enhanced configuration lookup strategy:
+  - Now checks current directory first (useful for bare repo worktrees)
+  - Then checks parent directory's main/master worktree
+  - Finally falls back to repository root
+- Improved path handling for worktree creation:
+  - Paths are now canonicalized to eliminate "../" in display
+  - "In subdirectory" option now correctly creates worktrees in subdirectories
+
+### Added
+
+- Edit hooks menu option (`λ`) for managing lifecycle hooks through the interface
+- Comprehensive Rustdoc documentation for all modules and functions
+- Current directory configuration lookup priority for .git-workers.toml
+- Parent directory configuration lookup for .git-workers.toml
+- Better error handling with mutex poison recovery in tests
+- Branch deletion functionality in batch delete operations
+- Orphaned branch detection when deleting worktrees
+- Repository URL validation in configuration files
+- New test files for batch delete and edit hooks functionality
+
+### Fixed
+
+- All clippy warnings resolved:
+  - manual_div_ceil replaced with div_ceil() method
+  - manual_unwrap_or patterns simplified
+  - needless_borrows in format! macros removed
+  - useless_vec replaced with arrays
+  - manual_flatten replaced with .flatten() method
+- Test failures related to parent directory configuration search
+- ESC cancellation pattern tests updated for new code style
+- Worktree rename test expectations aligned with Git limitations
+- "In subdirectory" option now correctly creates worktrees in worktrees/ folder
+- Path display now shows clean canonical paths without "../"
+- Batch delete now properly deletes orphaned branches
+- Edit hooks no longer incorrectly identifies regular repos as bare
+
+### Documentation
+
+- Updated README.md with current features and usage:
+  - Added configuration file lookup priority documentation
+  - Updated worktree pattern examples
+  - Added custom path creation examples
+  - Added repository URL configuration example
+  - Clarified batch delete branch deletion functionality
+- Enhanced CLAUDE.md with architectural details and development commands
+- Added detailed inline documentation for all public APIs
+- Updated all Rustdoc comments to reflect recent changes
+
+## [0.1.0] - 2024-12-17
+
+### Added
+
+- Initial release of Git Workers
+- Interactive menu-driven interface for Git worktree management
+- List worktrees with detailed status information (branch, changes, ahead/behind)
+- Fuzzy search through worktrees with real-time filtering
+- Create new worktrees from branches or HEAD
+- Delete single or multiple worktrees with safety checks
+- Switch worktrees with automatic directory change via shell integration
+- Rename worktrees and optionally their branches
+- Cleanup old worktrees by age
+- Hook system for lifecycle events (post-create, pre-remove, post-switch)
+- Shell integration for Bash and Zsh
+- Configuration file support (.git-workers.toml)
+- Template variable support in hooks ({{worktree_name}}, {{worktree_path}})
+- Worktree pattern detection for organized directory structure
+- ESC key support for cancelling operations
+- Colored terminal output with theme support
+- Progress indicators for long operations
+- Homebrew installation support

CLAUDE.md

@@ -32,6 +32,9 @@ cargo test test_name
 
 # Run tests single-threaded (for flaky tests)
 cargo test -- --test-threads=1
+
+# Run tests with output for debugging
+cargo test test_name -- --nocapture
 ```
 
 ### Quality Checks
@@ -46,6 +49,9 @@ cargo clippy --all-features -- -D warnings
 
 # Type check
 cargo check --all-features
+
+# Generate documentation
+cargo doc --no-deps --open
 ```
 
 ### Installation
@@ -75,6 +81,7 @@ src/
 ├── hooks.rs             # Hook system (post-create, pre-remove, etc.)
 ├── repository_info.rs   # Repository information display
 ├── input_esc_raw.rs     # Custom input handling with ESC support
+├── constants.rs         # Centralized constants (strings, formatting)
 └── utils.rs             # Common utilities (error display, etc.)
 ```
 
@@ -107,14 +114,12 @@ post-switch = ["echo 'Switched to {{worktree_name}}'"]
 ```
 
 Template variables:
-
 - `{{worktree_name}}`: The worktree name
 - `{{worktree_path}}`: Absolute path to worktree
 
 ### Worktree Patterns
 
 First worktree creation offers two options:
-
 1. Same level as repository: `../worktree-name`
 2. In subdirectory (recommended): `../repo/worktrees/worktree-name`
 
@@ -123,15 +128,13 @@ Subsequent worktrees follow the established pattern automatically.
 ### ESC Key Handling
 
 All interactive prompts support ESC cancellation through custom `input_esc_raw` module:
-
 - `input_esc_raw()` returns `Option<String>` (None on ESC)
 - `Select::interact_opt()` for menu selections
 - `Confirm::interact_opt()` for confirmations
 
 ### Worktree Rename Implementation
 
 Since Git lacks native rename functionality:
-
 1. Move directory with `fs::rename`
 2. Update `.git/worktrees/<name>` metadata directory
 3. Update gitdir files in both directions