docs: update README and CHANGELOG for v0.2.14

Author: ThomasRohde

CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.2.14] - 2025-12-09
+
+### 🐛 Fixed
+
+- **Windows UTF-8 encoding** - Fixed encoding error when applying worktree diffs containing UTF-8 characters on Windows. Now explicitly uses UTF-8 encoding for `git apply` operations.
+- **Auto-cleanup after --apply** - Worktrees are now automatically cleaned up (with force) after successfully applying changes to the main project. Previously, worktrees with modified/untracked files would remain and require manual cleanup.
+- **Exclude .klondike/ from worktree diffs** - When the agent runs `klondike feature start/verify` commands inside a worktree, those state changes no longer conflict when applying code back to the main project. Only actual code changes are applied; the main project's `.klondike/` state remains authoritative.
+
+### 📝 Changed
+
+- Updated README documentation for worktree commands
+- `klondike copilot cleanup` now documented with `--force` option for worktrees with uncommitted changes
+
+---
+
 ## [0.2.13] - 2025-12-09
 
 ### ✨ Added

README.md

@@ -86,14 +86,14 @@ klondike copilot start -w --name "refactor-auth"
 # Auto-cleanup worktree when session ends
 klondike copilot start -w --cleanup
 
-# Apply changes back to main project after session
+# Apply changes back to main project after session (auto-cleans up)
 klondike copilot start -w --apply
 
+# Force cleanup worktrees with uncommitted changes
+klondike copilot cleanup --force
+
 # List all active worktree sessions
 klondike copilot list
-
-# Remove all worktree sessions
-klondike copilot cleanup
 ```
 
 ### Worktree Directory Structure
@@ -111,10 +111,12 @@ Worktrees are created in a centralized location outside your project:
 ```
 
 The agent works in the worktree with a dedicated branch (`klondike/f001-abc123`), commits freely, and when done you can:
-- Apply the changes with `--apply`
+- Apply the changes with `--apply` (automatically cleans up the worktree)
 - Cherry-pick specific commits
 - Merge the branch manually
-- Or just delete it with `klondike copilot cleanup`
+- Or just delete it with `klondike copilot cleanup --force`
+
+> **Note**: When using `--apply`, klondike automatically excludes `.klondike/` state files from the diff, so only your code changes are applied. The klondike state in the main project remains authoritative.
 
 ---