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

## [1.3.2] - 2025-12-16

### Changed

#### 🔧 MCP Tool Description Optimization
- **Enhanced save_session tool guidance**: Added comprehensive step-by-step instructions in tool description to ensure AI assistant properly collects complete conversation history before saving
- **Improved content parameter description**: Added detailed requirements and examples to prevent summarization and ensure full conversation preservation
- **Better error prevention**: Added explicit warnings about prohibited behaviors (summarization, incomplete history, simplified formats)

#### 📝 Technical Improvements
- **Bidirectional interaction workaround**: While MCP protocol doesn't support bidirectional communication (tools cannot request data from AI), the optimized prompts guide the AI to proactively prepare complete conversation content
- **Enhanced user experience**: When users say "save current session", AI will now automatically organize full conversation history before calling MCP tool

### Technical Details

**Problem Solved**: 
- Previous behavior: AI might save conversation summaries instead of complete original dialogues
- New behavior: Strongly guided prompts ensure AI collects and formats complete conversation history

**Implementation**:
```
⚠️ Steps AI must execute before calling tool:
1. Internally organize complete conversation history
2. Format all user questions and AI answers in chronological order
3. Use clear Markdown format (# User, # AI Assistant headers)
4. Pass organized complete conversation as content parameter

❌ Prohibited behaviors:
- Passing conversation summaries
- Omitting any historical Q&A
- Using simplified formats

✅ Correct format example:
# User
[Complete content of first question...]

# AI Assistant
[Complete content of first answer...]
```

### Documentation
- No user-facing documentation updates required - changes are in tool descriptions only

---

## [1.3.1] - 2025-12-16

### Added
- 🌍 **Internationalization support** (i18n) for 4 languages:
  - Chinese (简体中文)
  - English
  - Japanese (日本語)
  - Korean (한국어)
- 📝 Bilingual README files with language switcher links
- 🔧 Configuration validation on startup
- 🔄 File write retry mechanism with exponential backoff
- 🧪 Comprehensive edge case testing
- 📚 I18N.md documentation

### Changed
- 📁 Reorganized project structure:
  - IDE configurations → `configs/`
  - Quick setup tools → `tools/`
  - Tests → `test/`
  - Documentation → `docs/`
  - Development notes → `dev/` (gitignored)
- ✨ Optimized MCP tool trigger prompts for better recognition
- 📦 Enhanced npm package configuration

### Fixed
- 🐛 Performance optimization for saving MD files
- 🔒 Path security validation to prevent traversal attacks
- ⚡ Directory caching to avoid repeated directory creation (99% reduction)

### Performance
- 🚀 10-28x faster single session save
- 🚀 28x faster consecutive saves (100 sessions)
- 🚀 11x higher throughput (558 sessions/sec vs 50/sec)

---

## [1.3.0] - 2025-12-15

### Added
- 🎯 Multi-IDE support configurations:
  - Qoder
  - Claude Desktop
  - Cursor
  - VSCode (Cline/Continue)
  - Windsurf (Codeium)
  - Aider
  - Trae
  - Codebuddy
  - Lingma
- 🛠️ Quick setup tools for automatic MCP configuration
- 📝 Comprehensive documentation (USAGE.md, MULTI_IDE_SETUP.md)

### Changed
- 🔧 Made `base_dir` parameter optional with smart defaults
- 📝 Enhanced tool descriptions with usage examples

---

## [1.2.0] - 2025-12-14

### Added
- ✅ Configuration file support (`config.json`)
- 🔍 Session search functionality
- 📋 Session listing with filtering
- 📖 Session reading
- 🗑️ Session deletion

### Changed
- 🎨 Improved file organization structure
- 📝 Enhanced Markdown output format

---

## [1.1.0] - 2025-12-13

### Added
- 💾 Basic session saving functionality
- 📂 Automatic directory creation
- 🕒 Timestamp-based file naming
- 📝 Markdown file generation

---

## [1.0.0] - 2025-12-12

### Added
- 🎉 Initial release
- 🔧 Basic MCP server setup
- 📦 Project structure