# Changelog

All notable changes to KERNL (formerly Project Mind) 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).

---

## [5.0.0] - 2026-01-07 - V2.0 COMPLETE! 🎉

**Major version bump (1.0.0 → 5.0.0) to reflect V2.0 milestone and alignment with tool count (75)**

### 🌟 Revolutionary Features

**V2.0 represents a complete transformation from stateless assistant to persistent intelligence layer**

#### Added - Testing & Integration (Phase 7)
- `sys_run_tests` - Automated test suite with 6 categories
- `sys_validate_tools` - Tool definition validation
- `sys_check_health` - System health monitoring with caching
- `sys_benchmark` - Performance benchmarking suite
- `sys_export_tools` - Export tool registry to JSON
- `sys_generate_docs` - Auto-generate documentation
- `sys_get_version` - Version information with feature flags

#### Added - Configuration & Meta (Phase 6)
- `sys_get_config` - Get KERNL configuration
- `sys_set_config_value` - Update configuration values
- `sys_get_usage_stats` - Tool usage analytics
- `sys_get_tool_info` - Tool introspection
- `sys_copy_path` - Copy files/directories
- `sys_delete_path` - Delete files/directories
- `sys_path_exists` - Check path existence
- `sys_move_path` - Move/rename paths
- `sys_create_directory` - Create directories (already existed, now in sys_ namespace)

#### Added - Process Management (Phase 5)
- `sys_start_process` - Start process with smart REPL detection
- `sys_interact_with_process` - Send input to running processes
- `sys_read_process_output` - Read process output with pagination
- `sys_list_sessions` - List active process sessions
- `sys_list_processes` - List system processes
- `sys_kill_process` - Terminate process by PID
- `sys_force_terminate` - Force terminate session

#### Added - Advanced Search (Phase 4)
- `sys_start_search` - Start background search
- `sys_get_more_search_results` - Paginate search results
- `sys_stop_search` - Stop active search
- `sys_list_searches` - List active searches

#### Added - Enhanced File Operations (Phase 3)
- Enhanced `pm_get_file_info` with text metadata (line counts)
- Base64 image support in `pm_read_file`
- Improved format detection and handling

#### Added - Revolutionary Tools (Phase 2)
- `sys_edit_block` - Surgical file editing with find/replace
- `sys_write_pdf` - PDF creation and modification
- `sys_copy_file_user_to_claude` - Bridge user↔Claude filesystems
- Enhanced process tools with REPL support

#### Added - Foundation (Phase 1)
- Complete MCP server architecture
- SQLite database with WAL mode
- TypeScript strict mode compilation
- Project registry system
- Session state management
- ONNX embedding support

### 🏆 Milestones Achieved

- ✅ **75 tools** across 17 categories
- ✅ **100% Desktop Commander parity**
- ✅ **Self-documenting system** with introspection
- ✅ **Comprehensive testing** suite
- ✅ **Zero new TypeScript errors**
- ✅ **Production-ready quality**

### 📊 V2.0 Statistics

- Total tools: 75 (from 41 in v1.0.0)
- Tool categories: 17 (from 7 in v1.0.0)
- Development phases: 7
- Total implementation time: ~9.5 hours
- Documentation: 1,565+ lines added

### 🎯 Revolutionary Capabilities

1. **Crash Recovery** - Automatic checkpoints survive timeouts
2. **Semantic Search** - ONNX-powered meaning-based discovery
3. **Cross-Project Learning** - Pattern recognition and suggestions
4. **Full System Control** - Complete desktop authority
5. **Process Management** - Interactive REPLs with smart detection
6. **Advanced Search** - Background execution with streaming
7. **Git Integration** - Smart commit generation
8. **Chrome Export** - Conversation history export
9. **Testing Suite** - Automated validation and health checks
10. **Self-Documentation** - Auto-generated docs and introspection

### 🔧 Technical Improvements

- Tool registry for introspection and testing
- Health check caching (1-minute TTL)
- Performance benchmarking framework
- Comprehensive test suite (6 categories)
- Documentation generation (markdown, HTML, JSON)
- Version tracking with feature flags

### 📚 Documentation

- Added V2_COMPLETE.md (824 lines) - Complete V2.0 overview
- Added PHASE_7_COMPLETE.md (741 lines) - Phase 7 details
- Updated README.md with V2.0 information
- Created TOOL_REFERENCE.md (1,325 lines) - All 75 tools
- Created CHANGELOG.md - Version history

### Breaking Changes

- **Namespace changes:** Many tools moved to `sys_` prefix for consistency
- **Version jump:** 1.0.0 → 5.0.0 (aligns with V2.0 and tool count)
- **Configuration structure:** Updated for new features

### Migration Guide

**From v1.0.0 to v5.0.0 (V2.0):**

1. **Tool renames:** Some tools gained `sys_` prefix
   - `create_directory` → `sys_create_directory`
   - `edit_block` → `sys_edit_block`
   - `write_pdf` → `sys_write_pdf`

2. **New capabilities:** 34 new tools added (41 → 75)
   - Process management (7 tools)
   - Advanced search (4 tools)
   - Configuration & meta (4 tools)
   - Testing & integration (7 tools)

3. **Configuration updates:** New features can be toggled
   ```typescript
   sys_set_config_value({ key: 'features.crashRecovery', value: true })
   ```

4. **Testing:** Run validation after upgrade
   ```typescript
   sys_run_tests({ category: 'all' })
   sys_validate_tools({ verbose: true })
   sys_check_health({ quick: false })
   ```

---

## [1.0.0] - 2025-12-XX - Initial Release

### Added

**Initial release of Project Mind MCP with 41 tools**

#### Session Management (5 tools)
- `check_resume_needed` - Detect incomplete work
- `auto_checkpoint` - Automatic progress saves
- `mark_complete` - Clear resume state
- `get_session_state` - Manual state check
- `save_session_state` - Manual checkpoint

#### Project Management (4 tools)
- `pm_register_project` - Register projects
- `pm_list_projects` - List all projects
- `pm_get_project` - Get project details
- `pm_update_project` - Update configuration

#### Filesystem Operations (8 tools)
- `pm_read_file` - Read with format detection
- `pm_write_file` - Write with format handling
- `pm_list_files` - Directory listing
- `pm_batch_read` - Batch file operations
- `pm_index_files` - Index for search
- `pm_index_status` - Check index status
- `pm_search_files` - Find files in project
- `pm_get_file_info` - Get file metadata

#### Intelligence Features (2 tools)
- `search_semantic` - Semantic file search
- `suggest_patterns` - Cross-project patterns

#### Backlog Management (4 tools)
- `query_backlog` - List EPICs with filtering
- `add_epic` - Create new EPICs
- `complete_epic` - Mark EPICs done
- `get_project_status` - Project overview

#### Git Operations (2 tools)
- `smart_commit` - Auto-generated commit messages
- `session_package` - Package session for commit

#### Research (2 tools)
- `research_progressive` - Streaming research
- `search_research` - Search research history

#### Background Jobs (14 tools)
- Job creation and management
- Progress tracking
- Background execution
- Status monitoring

### Features

- **Persistent Intelligence** - Session state survives crashes
- **Semantic Search** - ONNX-powered file discovery
- **Cross-Project Learning** - Pattern recognition
- **Multi-Format Support** - Excel, PDF, images, text
- **Git Integration** - Smart commit generation
- **Research Capabilities** - Progressive streaming

### Technical

- MCP (Model Context Protocol) server
- SQLite database with WAL mode
- ONNX Runtime for embeddings
- TypeScript with strict mode
- Comprehensive error handling

---

## Version History Summary

| Version | Release Date | Tools | Major Changes |
|---------|-------------|-------|---------------|
| 5.0.0 (V2.0) | 2026-01-07 | 75 | Complete transformation, Desktop Commander parity |
| 1.0.0 | 2025-12-XX | 41 | Initial release, core persistence features |

---

## Upgrade Paths

### v1.0.0 → v5.0.0 (V2.0)

**Required Actions:**
1. Update configuration file paths if using custom locations
2. Review tool renames (some tools now use `sys_` prefix)
3. Run `sys_validate_tools()` to verify compatibility
4. Run `sys_run_tests({ category: 'all' })` to validate system
5. Check `sys_check_health()` for any issues

**Optional Actions:**
1. Enable new features via `sys_set_config_value()`
2. Index existing projects: `pm_index_files({ project, reindex: true })`
3. Generate documentation: `sys_generate_docs({ format: 'markdown' })`
4. Export tool registry: `sys_export_tools({ format: 'full' })`

---

## Deprecation Notice

### Deprecated in v5.0.0

**None** - All v1.0.0 tools remain functional

### Renamed in v5.0.0

- Some tools gained `sys_` prefix for consistency
- Old names still work but may be deprecated in future

---

## Known Issues

### v5.0.0

- 11 pre-existing TypeScript errors in export modules (non-blocking)
- Chrome export requires Chrome browser installed
- Some formats (archives, videos) have limited metadata extraction

### v1.0.0

- Limited format support
- No process management
- No advanced search
- No testing suite

---

## Future Roadmap

### v5.1 (V2.1) - Q1 2026
- Web UI for project management
- Real-time file watching
- Enhanced pattern visualization
- Additional format support
- Bug fixes and performance improvements

### v5.2 (V2.2) - Q2 2026
- Multi-platform support (ChatGPT, Gemini)
- Cloud sync for session state
- Team collaboration features
- Advanced analytics dashboard

### v6.0 (V3.0) - Q3 2026
- Distributed pattern learning
- Enterprise features (SSO, audit logs)
- Advanced security features
- Plugin ecosystem

---

## Credits

### V2.0 Development
- **Architect & Lead Developer:** David
- **Development Duration:** ~9.5 hours across 7 phases
- **Tools Implemented:** 75 across 17 categories
- **Documentation:** 3,000+ lines

### Acknowledgments
- Desktop Commander - Inspiration for system control patterns
- MCP Protocol - Foundation for AI integration
- TypeScript - Type-safe development
- ONNX Runtime - Local AI inference

---

## License

MIT License - see [LICENSE](LICENSE) file

---

## Links

- **Repository:** https://github.com/yourusername/kernl-mcp
- **Documentation:** [docs/](docs/)
- **NPM Package:** https://www.npmjs.com/package/kernl-mcp
- **Issues:** https://github.com/yourusername/kernl-mcp/issues
- **Discussions:** https://github.com/yourusername/kernl-mcp/discussions

---

**KERNL - Transforming AI from stateless to persistent intelligence**

*Made with ❤️ by developers who refuse to accept the 8-minute death*