# Changelog

All notable changes to this project will be documented in this file.

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).

## [Unreleased]

## [0.5.0] - 2026-01-15

### Added

- **Cost Tracking System** - Track LLM API costs across sessions
  - New `:CoderCost` command opens cost estimation floating window
  - Session costs tracked in real-time
  - All-time costs persisted in `.coder/cost_history.json`
  - Per-model breakdown with token counts
  - Pricing database for 50+ models (GPT-4/5, Claude, O-series, Gemini)
  - Window keymaps: `q` close, `r` refresh, `c` clear session, `C` clear all

- **Automatic Ollama Fallback** - Graceful degradation when API limits hit
  - Automatically switches to Ollama when Copilot rate limits exceeded
  - Detects local Ollama availability before fallback
  - Notifies user of provider switch

- **Enhanced Error Handling** - Better error messages for API failures
  - Shows actual API response on parse errors (not generic "failed to parse")
  - Improved rate limit detection and messaging
  - Sanitized newlines in error notifications to prevent UI crashes

- **Agent Tools System Improvements**
  - New `to_openai_format()` and `to_claude_format()` functions
  - `get_definitions()` for generic tool access
  - Fixed tool call argument serialization (JSON strings vs tables)

- **Credentials Management System** - Store API keys outside of config files
  - New `:CoderAddApiKey` command for interactive credential setup
  - `:CoderRemoveApiKey` to remove stored credentials
  - `:CoderCredentials` to view credential status
  - `:CoderSwitchProvider` to switch active LLM provider
  - Credentials stored in `~/.local/share/nvim/codetyper/configuration.json`
  - Priority: stored credentials > config > environment variables
  - Supports all providers: Claude, OpenAI, Gemini, Copilot, Ollama

### Changed

- Cost window now shows both session and all-time statistics
- Improved agent prompt templates with correct tool names
- Better error context in LLM provider responses

### Fixed

- Fixed "Failed to parse Copilot response" error showing instead of actual error
- Fixed `nvim_buf_set_lines` crash from newlines in error messages
- Fixed `tools.definitions` nil error in agent initialization
- Fixed tool name mismatch in agent prompts (write_file vs write)

---

## [0.4.0] - 2026-01-13

### Added

- **Event-Driven Architecture** - Complete rewrite of prompt processing system
  - Prompts are now treated as events with metadata (buffer state, priority, timestamps)
  - New modules: `queue.lua`, `patch.lua`, `confidence.lua`, `worker.lua`, `scheduler.lua`
  - Priority-based event queue with observer pattern
  - Buffer snapshots for staleness detection

- **Optimistic Execution** - Ollama as fast local scout
  - Use Ollama for first attempt (fast local inference)
  - Automatically escalate to remote LLM if confidence is low
  - Configurable escalation threshold (default: 0.7)

- **Confidence Scoring** - Response quality heuristics
  - 5 weighted heuristics: length, uncertainty phrases, syntax completeness, repetition, truncation
  - Scores range from 0.0-1.0
  - Determines whether to escalate to more capable LLM

- **Staleness Detection** - Safe patch application
  - Track `vim.b.changedtick` and content hash at prompt time
  - Discard patches if buffer changed during generation
  - Prevents stale code injection

- **Completion-Aware Injection** - No fighting with autocomplete
  - Defer code injection while completion popup visible
  - Works with native popup, nvim-cmp, and coq_nvim
  - Configurable delay after popup closes (default: 100ms)

- **Tree-sitter Scope Resolution** - Smart context extraction
  - Automatically resolves prompts to enclosing function/method/class
  - Falls back to heuristics when Tree-sitter unavailable
  - Scope types: function, method, class, block, file

- **Intent Detection** - Understands what you want
  - Parses prompts to detect: complete, refactor, fix, add, document, test, optimize, explain
  - Intent determines injection strategy (replace vs insert vs append)
  - Priority adjustment based on intent type

- **Tag Precedence Rules** - Multiple tags handled cleanly
  - First tag in scope wins (FIFO ordering)
  - Later tags in same scope skipped with warning
  - Different scopes process independently

### Configuration

New `scheduler` configuration block:
```lua
scheduler = {
  enabled = true,           -- Enable event-driven mode
  ollama_scout = true,      -- Use Ollama first
  escalation_threshold = 0.7,
  max_concurrent = 2,
  completion_delay_ms = 100,
}
```

---

## [0.3.0] - 2026-01-13

### Added

- **Multiple LLM Providers** - Support for additional providers beyond Claude and Ollama
  - OpenAI API with custom endpoint support (Azure, OpenRouter, etc.)
  - Google Gemini API
  - GitHub Copilot (uses existing copilot.lua/copilot.vim authentication)

- **Agent Mode** - Autonomous coding assistant with tool use
  - `read_file` - Read file contents
  - `edit_file` - Edit files with find/replace
  - `write_file` - Create or overwrite files
  - `bash` - Execute shell commands
  - Real-time logging of agent actions
  - `:CoderAgent`, `:CoderAgentToggle`, `:CoderAgentStop` commands

- **Transform Commands** - Transform /@ @/ tags inline without split view
  - `:CoderTransform` - Transform all tags in file
  - `:CoderTransformCursor` - Transform tag at cursor
  - `:CoderTransformVisual` - Transform selected tags
  - Default keymaps: `<leader>ctt` (cursor/visual), `<leader>ctT` (all)

- **Auto-Index Feature** - Automatically create coder companion files
  - Creates `.coder.` companion files when opening source files
  - Language-aware templates with correct comment syntax
  - `:CoderIndex` command to manually open companion
  - `<leader>ci` keymap
  - Configurable via `auto_index` option (disabled by default)

- **Logs Panel** - Real-time visibility into LLM operations
  - Token usage tracking (prompt and completion tokens)
  - "Thinking" process visibility
  - Request/response logging
  - `:CoderLogs` command to toggle panel

- **Mode Switcher** - Switch between Ask and Agent modes
  - `:CoderType` command shows mode selection UI

### Changed

- Window width configuration now uses percentage as whole number (e.g., `25` for 25%)
- Improved code extraction from LLM responses
- Better prompt templates for code generation

### Fixed

- Window width calculation consistency across modules

---

## [0.2.0] - 2026-01-11

### Added

- **Ask Panel** - Chat interface for asking questions about code
  - Fixed at 1/4 (25%) screen width for consistent layout
  - File attachment with `@` key (uses Telescope if available)
  - `Ctrl+n` to start a new chat (clears input and history)
  - `Ctrl+Enter` to submit questions
  - `Ctrl+f` to add current file as context
  - `Ctrl+h/j/k/l` for window navigation
  - `K/J` to jump between output and input windows
  - `Y` to copy last response to clipboard
  - `q` to close panel (closes both windows together)
- Auto-open Ask panel on startup (configurable via `auto_open_ask`)
- File content is now sent to LLM when attaching files with `@`

### Changed

- Ask panel width is now fixed at 25% (1/4 of screen)
- Improved close behavior - closing either Ask window closes both
- Proper focus management after closing Ask panel
- Compact UI elements to fit 1/4 width layout
- Changed "Assistant" label to "AI" in chat messages

### Fixed

- Ask panel window state sync issues
- Window focus returning to code after closing Ask panel
- NerdTree/nvim-tree causing Ask panel to resize incorrectly

---

## [0.1.0] - 2026-01-11

### Added

- Initial release of Codetyper.nvim
- Core plugin architecture with modular Lua structure
- Split window view for coder and target files
- Tag-based prompt system (`/@` to open, `@/` to close)
- Claude API integration for code generation
- Ollama API integration for local LLM support
- Automatic `.gitignore` management for coder files and `.coder/` folder
- Smart prompt type detection (refactor, add, document, explain)
- Code injection system with multiple strategies
- User commands: `Coder`, `CoderOpen`, `CoderClose`, `CoderToggle`, `CoderProcess`, `CoderTree`, `CoderTreeView`
- Health check module (`:checkhealth codetyper`)
- Comprehensive documentation and help files
- Telescope integration for file selection (optional)
- **Project tree logging**: Automatic `.coder/tree.log` maintenance
  - Updates on file create, save, delete
  - Debounced updates (1 second) for performance
  - File type icons for visual clarity
  - Ignores common build/dependency folders

### Configuration Options

- LLM provider selection (Claude/Ollama)
- Window position and width customization
- Custom prompt tag patterns
- Auto gitignore toggle

---

## Version History

### Legend

- **Added** - New features
- **Changed** - Changes in existing functionality
- **Deprecated** - Soon-to-be removed features
- **Removed** - Removed features
- **Fixed** - Bug fixes
- **Security** - Vulnerability fixes

[Unreleased]: https://github.com/cargdev/codetyper.nvim/compare/v0.5.0...HEAD
[0.5.0]: https://github.com/cargdev/codetyper.nvim/compare/v0.4.0...v0.5.0
[0.4.0]: https://github.com/cargdev/codetyper.nvim/compare/v0.3.0...v0.4.0
[0.3.0]: https://github.com/cargdev/codetyper.nvim/compare/v0.2.0...v0.3.0
[0.2.0]: https://github.com/cargdev/codetyper.nvim/compare/v0.1.0...v0.2.0
[0.1.0]: https://github.com/cargdev/codetyper.nvim/releases/tag/v0.1.0