refactor: extract broadcast functions and add ClaudeCodeAdd command

- Extract broadcast_at_mention() for single file broadcasts
- Extract add_paths_to_claude() for batch operations with optional delays
- Refactor all existing handlers to use centralized functions
- Add ClaudeCodeAdd <file-path> command for direct file addition
- Remove verbose comments that describe "what" instead of "why"
- Add comprehensive documentation to README with examples
- Add 13 test cases covering command registration, validation, and functionality
- Maintain all existing functionality and test compatibility (164 tests passing)

Change-Id: I171dbc0bcc82d72c5c9a4f3d891a71fc3c814dbc
Signed-off-by: Thomas Kosiewski <[email protected]>

Author: ThomasK33

Makefile

@@ -1,7 +1,7 @@
 .PHONY: check format test clean
 
 # Default target
-all: check format
+all: format check test
 
 # Check for syntax errors
 check:

README.md

@@ -81,6 +81,7 @@ That's it! For more configuration options, see [Advanced Setup](#advanced-setup)
 - `:ClaudeCode` - Toggle the Claude Code terminal window
 - `:ClaudeCodeSend` - Send current visual selection to Claude, or add files from tree explorer
 - `:ClaudeCodeTreeAdd` - Add selected file(s) from tree explorer to Claude context (also available via ClaudeCodeSend)
+- `:ClaudeCodeAdd <file-path>` - Add a specific file or directory to Claude context by path
 
 ### Tree Integration
 
@@ -98,6 +99,39 @@ This allows you to quickly add entire files to Claude's context for review, refa
 - **Smart detection**: Automatically detects whether you're in nvim-tree or neo-tree
 - **Error handling**: Clear feedback if no files are selected or if tree plugins aren't available
 
+### Direct File Addition
+
+The `:ClaudeCodeAdd` command allows you to add files or directories directly by path:
+
+```vim
+:ClaudeCodeAdd src/main.lua
+:ClaudeCodeAdd ~/projects/myproject/
+:ClaudeCodeAdd ./README.md
+```
+
+#### Features
+
+- **Path completion**: Tab completion for file and directory paths
+- **Path expansion**: Supports `~` for home directory and relative paths
+- **Validation**: Checks that files and directories exist before adding
+- **Flexible**: Works with both individual files and entire directories
+
+#### Examples
+
+```vim
+" Add a specific file
+:ClaudeCodeAdd src/components/Header.tsx
+
+" Add an entire directory
+:ClaudeCodeAdd tests/
+
+" Add file in home directory
+:ClaudeCodeAdd ~/.config/nvim/init.lua
+
+" Add relative path
+:ClaudeCodeAdd ../other-project/package.json
+```
+
 ## How It Works
 
 This plugin creates a WebSocket server that Claude Code CLI connects to, implementing the same protocol as the official VS Code extension. When you launch Claude, it automatically detects Neovim and gains full access to your editor.