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

## [Unreleased]
## [0.11.6] - 2026-06-18

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-config
## [0.11.5] - 2026-06-05

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-config
## [0.11.4] - 2026-06-03

### ⚙️  Miscellaneous
- Updated the following local packages: thoughts-tool
## [0.11.3] - 2026-05-20

### ⛰️  Features
- Add configurable runtime timeouts across agentic tools

### 🐛 Bug Fixes
- *(logging)* Address PR #220 timeout and failure handling review fixes
## [0.11.2] - 2026-05-19

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-config
## [0.11.1] - 2026-05-07

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-tools-core, agentic_logging, agentic-tools-mcp, thoughts-tool
## [0.11.0] - 2026-05-04

### 🐛 Bug Fixes
- *(gpt5_reasoner)* Raise completion headroom and log executor diagnostics
- [**breaking**] Remove legacy reasoning compatibility paths

### 🐛 Bug Fixes

- *(gpt5_reasoner)* Add explicit completion token caps and richer executor diagnostics
- *(gpt5_reasoner)* [**breaking**] JSONL `summary` no longer includes legacy short executor keys (`attempt`, `duration_ms`, `chunks`, `first_content_ms`, `usage_present`). Use descriptive keys only; `attempt_index` (0-based) is now the only attempt counter.

## [0.10.0] - 2026-05-03

### ⛰️  Features
- *(gpt5_reasoner)* Stream executor responses with recovery

### 🧪 Testing
- *(gpt5_reasoner)* Guard api base url env mutation
## [0.9.0] - 2026-05-03

### ⛰️  Features
- *(tools)* Apply cancellation to long-running tools

### 🐛 Bug Fixes
- *(tools)* Preserve cancellation semantics in bounded tool paths
## [0.8.6] - 2026-04-17

### ⚙️  Miscellaneous
- Updated the following local packages: thoughts-tool
## [0.8.5] - 2026-04-15

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-tools-core, agentic-tools-mcp, thoughts-tool
## [0.8.4] - 2026-04-13
## [0.8.3] - 2026-04-13

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-tools-core, thoughts-tool, agentic-tools-mcp
## [0.8.2] - 2026-04-06

### ⛰️  Features
- *(thoughts-tool)* Improve sync reliability and add shareable URL generation
## [0.8.1] - 2026-03-27

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-config
## [0.8.0] - 2026-03-26
## [0.7.2] - 2026-03-26

### ⚙️  Miscellaneous
- Updated the following local packages: thoughts-tool
## [0.7.1] - 2026-03-26

### 🚜 Refactor
- *(policy)* Reserve mcp=true for runtime MCP server apps only
## [0.7.0] - 2026-03-10

### ⚙️  Miscellaneous
- *(deps)* Upgrade 13 dependencies to latest versions

### 🐛 Bug Fixes
- *(gpt5_reasoner)* Canonicalize cwd for consistent path resolution
## [0.6.2] - 2026-03-05

### ⚙️  Miscellaneous
- Updated the following local packages: agentic-tools-core, agentic-tools-mcp, thoughts-tool
## [0.6.1] - 2026-02-10

### ⚙️  Miscellaneous
- Updated the following local packages: thoughts-tool
## [0.6.0] - 2026-01-30

### ⛰️  Features
- Agentic-tools framework and monorepo restructure
- [**breaking**] Rename tools with category-based prefixes and consolidate MCP server
- *(gpt5_reasoner)* [**breaking**] Upgrade executor to GPT-5.2 with xhigh reasoning
- *(xtask)* Add README auto-generation with tiered crate listings

### Breaking Changes
- **gpt5_reasoner**: Executor model changed from `openai/gpt-5` to `openai/gpt-5.2`
- **gpt5_reasoner**: Reasoning effort increased from `High` to `Xhigh`
  - Requires access to `openai/gpt-5.2` on OpenRouter/OpenAI
  - May increase cost/latency compared to previous configuration
  - Introduced `EXECUTOR_MODEL` constant to centralize model string
- **async-openai**: Upgraded to v0.32 with `chat-completion` feature

## [0.5.2] - 2026-01-05

### ⚙️  Miscellaneous
- Updated the following local packages: thoughts-tool
## [0.5.1] - 2026-01-04

### ⚙️  Miscellaneous
- *(agentic_logging)* Release v0.1.1
## [0.5.0] - 2026-01-04

### ⚙️  Miscellaneous
- Address PR review nits
- Address additional PR review nits

### ⛰️  Features
- *(gpt5_reasoner)* Add output_filename param and logging integration

### 🐛 Bug Fixes
- *(deps)* Add explicit versions to path dependencies for cargo-deny
- *(gpt5_reasoner)* Complete JSONL logging for all execution paths
- Fix

### 🚜 Refactor
- *(gpt5_reasoner)* Remove unnecessary clone calls

### 🧪 Testing
- Add logging integration tests and output_filename docs
## [0.4.6] - 2026-01-03

### 🚜 Refactor
- *(build)* Migrate from Makefile to Just build system
- Update agent guidance to use MCP Just tools instead of shell commands
## [0.4.5] - 2026-01-02

### ⚙️  Miscellaneous
- Updated the following local packages: universal-tool-core
## [0.4.4] - 2025-12-27

### 🐛 Bug Fixes
- Correct typos and spelling in templates and prompts
## [0.4.3] - 2025-12-16

### ⚙️  Miscellaneous
- *(build)* Standardize Makefile targets for local/CI parity
- *(build)* Add fmt check to check-verbose targets across all Makefiles
## [0.4.2] - 2025-11-20

### 🐛 Bug Fixes
- Improve shell script trap patterns across monorepo
## [0.4.1] - 2025-11-04

### ⚙️  Miscellaneous
- Update Cargo.lock dependencies
## [0.4.0] - 2025-11-04

### 🐛 Bug Fixes
- *(gpt5_reasoner)* Inject CLAUDE.md from explicit directories with zero matching files
- *(gpt5_reasoner)* Add diagnostic logging and fix empty response handling
## [0.3.3] - 2025-10-20

### ⚙️  Miscellaneous
- *(metadata)* Add missing keywords and categories to pr_comments and gpt5_reasoner
## [0.3.2] - 2025-10-20

### ⛰️  Features
- *(gpt5_reasoner)* Add automatic CLAUDE.md discovery and injection

### 🐛 Bug Fixes
- *(gpt5_reasoner)* Resolve macOS symlink mismatch in CLAUDE.md auto-injection
- *(gpt5_reasoner)* Resolve test race conditions in env/cwd mutations
- *(gpt5_reasoner)* Resolve macOS symlink canonicalization in DirGuard test

### 📚 Documentation
- Align root documentation and build targets for all 5 tools

### 🚜 Refactor
- *(gpt5_reasoner)* Extract lib.rs into focused engine modules
## [0.3.1] - 2025-10-16

### ⚙️  Miscellaneous
- Updated the following local packages: universal-tool-core
## [0.3.0] - 2025-10-08

### ⛰️  Features
- *(gpt5_reasoner)* Add file validation and improve MCP interface

### 🐛 Bug Fixes
- *(gpt5_reasoner)* Handle nested code fences in LLM output parsing
- *(gpt5_reasoner)* Resolve symlinks in path normalization for macOS

## [0.2.1] - 2025-10-07

### ⚙️  Miscellaneous
- Updated the following local packages: universal-tool-core

## [0.2.0] - 2025-10-06

### ⛰️  Features
- *(gpt5_reasoner)* [**breaking**] Add directory support and change default optimizer model

### Added
- Directory support: Accept directories via `DirectoryMeta` with automatic file expansion
- Configurable directory traversal: recursive, hidden files, extension filtering, max_files cap
- Binary file detection and automatic skipping during directory expansion
- Path normalization to absolute paths (without symlink resolution)
- Example JSON files for directory usage (`examples/directories.json`, `examples/empty_files.json`)
- Comprehensive directory expansion tests (7 new tests)
- Model selection tests with proper thread-safe env var handling (3 new tests)

### Changed
- **BREAKING**: Default optimizer model changed from `openai/gpt-5` to `anthropic/claude-sonnet-4.5`
- **BREAKING**: `gpt5_reasoner_impl` signature now includes `directories: Option<Vec<DirectoryMeta>>` parameter
- **BREAKING**: `optimize_and_execute` MCP/CLI function now accepts optional `directories` parameter
- CLI now accepts `--directories-json` for directory-based file discovery
- Total test count increased from 30 to 40 tests

### Notes
- Executor model remains unchanged: `openai/gpt-5`
- OPTIMIZER_MODEL precedence: parameter > env var > default
- Directory expansion happens before optimizer sees files
- Deduplication ensures files don't appear twice if listed in both files and directories
- Hidden directories are pruned from traversal when `include_hidden=false`
- Extension filter is case-insensitive and accepts both "rs" and ".rs" formats

## [0.1.0] - 2025-10-06

### Added
- Initial release of gpt5_reasoner tool
- Two-phase prompt optimization (optimizer → executor pattern)
- Support for reasoning and plan prompt types
- Defensive plan template injection with executor-side guards
- Application-level retry logic for network errors
- Token counting and enforcement (250k limit)
- Dual CLI and MCP interfaces via universal-tool framework
- Concurrent file reading for performance
- Comprehensive test coverage (30 tests)
