feat: add configurable auto-close terminal behavior and enhanced state management

- Add auto_close configuration option (default: true) to control terminal lifecycle
- Refactor terminal.lua into modular provider architecture with separate snacks and native providers
- Simplify terminal state management using :buf_valid() instead of complex state tracking
- Remove Snacks.terminal.get() usage to avoid invalid instance caching bugs
- Add comprehensive error reporting with detailed context for terminal creation failures
- Update README.md with auto_close documentation and usage examples
- Add vim.v type definitions to eliminate LSP warnings
- Update dev-config.lua with auto_close example
- Maintain 100% API compatibility while improving reliability

Change-Id: Iabc80707bf5f23890075c20d0f2abbdfa443e34e
Signed-off-by: Thomas Kosiewski <tk@coder.com>

Author: ThomasK33

README.md

@@ -112,7 +112,7 @@ The `:ClaudeCodeAdd` command allows you to add files or directories directly by
 :ClaudeCodeAdd ~/projects/myproject/
 :ClaudeCodeAdd ./README.md
 :ClaudeCodeAdd src/main.lua 50 100    " Lines 50-100 only
-:ClaudeCodeAdd config.lua 25          " From line 25 to end of file
+:ClaudeCodeAdd config.lua 25          " Only line 25
 ```
 
 #### Features
@@ -136,7 +136,7 @@ The `:ClaudeCodeAdd` command allows you to add files or directories directly by
 
 " Add specific line ranges
 :ClaudeCodeAdd src/main.lua 50 100        " Lines 50 through 100
-:ClaudeCodeAdd config.lua 25              " From line 25 to end of file
+:ClaudeCodeAdd config.lua 25              " Only line 25
 :ClaudeCodeAdd utils.py 1 50              " First 50 lines
 :ClaudeCodeAdd README.md 10 20            " Just lines 10-20
 
@@ -200,6 +200,7 @@ See [DEVELOPMENT.md](./DEVELOPMENT.md) for build instructions and development gu
       split_side = "right",
       split_width_percentage = 0.3,
       provider = "snacks", -- or "native"
+      auto_close = true, -- Auto-close terminal after command completion
     },
 
     -- Diff options
@@ -227,6 +228,29 @@ See [DEVELOPMENT.md](./DEVELOPMENT.md) for build instructions and development gu
 
 </details>
 
+### Terminal Auto-Close Behavior
+
+The `auto_close` option controls what happens when Claude commands finish:
+
+**When `auto_close = true` (default):**
+
+- Terminal automatically closes after command completion
+- Error notifications shown for failed commands (non-zero exit codes)
+- Clean workflow for quick command execution
+
+**When `auto_close = false`:**
+
+- Terminal stays open after command completion
+- Allows reviewing command output and any error messages
+- Useful for debugging or when you want to see detailed output
+
+```lua
+terminal = {
+  provider = "snacks",
+  auto_close = false, -- Keep terminal open to review output
+}
+```
+
 ## Troubleshooting
 
 - **Claude not connecting?** Check `:ClaudeCodeStatus` and verify lock file exists in `~/.claude/ide/`

dev-config.lua

@@ -40,6 +40,7 @@ return {
     -- terminal_cmd = "claude --debug",
     -- terminal = {
     --   provider = "native",
+    --   auto_close = false, -- Keep terminals open to see output
     -- },
   },
 }

lua/claudecode/meta/vim.lua

@@ -79,9 +79,13 @@
 ---@field termopen fun(cmd: string|string[], opts?: table):number For vim.fn.termopen()
 -- Add other vim.fn functions as needed
 
+---@class vim_v_table
+---@field event table Event data containing status and other event information
+
 ---@class vim_global_api
 ---@field notify fun(msg: string | string[], level?: number, opts?: vim_notify_opts):nil
 ---@field log vim_log
+---@field v vim_v_table For vim.v.event access
 ---@field _last_echo table[]? table of tables, e.g. { {"message", "HighlightGroup"} }
 ---@field _last_error string?
 ---@field o vim_options_table For vim.o.option_name