PAELLADOC

# Changelog All notable changes to PAELLADOC 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). ## [0.3.7] - 2025-04-25 ### Fixed - Restored missing core plugin files (`project_crud.py`, `project_utils.py`) that were inadvertently excluded from the v0.3.6 package build, making tools like `core_get_project`, `core_update_project`, and `core_delete_project` available again. ======= ## [0.3.6] - 2025-04-25 ### Added - Improved project management with reliable active project tracking. - Enhanced MCP tools for better project organization and documentation. - New CRUD operations for managing templates, coding styles, and product documentation. - Comprehensive test coverage ensuring reliable operation. ### Changed - Simplified project activation system for better user experience. - More intuitive MCP tool organization following SOLID principles. - Better error handling and user feedback in project operations. - Refactored internal user management system for increased reliability and future extensibility. ### Improved - More reliable project state management and database operations. - Enhanced internal testing procedures for better quality assurance. - Cleaner and more maintainable codebase. ### Fixed - Resolved internal issues that could potentially affect application stability under certain conditions. - Corrected problems interfering with internal automated testing, ensuring changes are verified more accurately. - Resolved internal issues that could potentially affect application stability under certain conditions, particularly during initial setup or testing. ## [0.3.5] - 2025-04-24 ### Added - Flexible configuration system for customizing tool behavior without code changes - Dynamic bucket prioritization allowing projects to define workflow sequences - Improved command metadata system with enhanced documentation and examples - New Contributor License Agreement (CLA) for managing external contributions ### Changed - Enhanced project structure visualization with more intuitive phase completion reporting - Standardized command naming convention across all tools - Improved error reporting with more actionable messages - Updated project license to better align with community needs - Added formal contribution process with CLA requirements ### Fixed - Corrected compatibility issues that prevented proper operation in Claude Desktop - Resolved dependency injection initialization problems in certain environments ### Improved - More reliable project initialization and continuation workflows - Better taxonomy validation with clearer validation error messages - Optimized project listing operation ## [0.3.4] - 2025-04-23 ### Fixed - Corrected `UUID` type usage in Alembic migration `297f102e7967` to resolve CI failures (`AttributeError` for `GUID`). ### Changed - Standardized core MCP tool naming convention (using underscores, e.g., `paella_init`). - Refactored taxonomies to use `importlib.resources` for better packaging and access. - Enhanced `ProjectInfo` serialization and database interactions. - Updated core tool documentation and help messages to use Markdown. ### Added - Introduced mandatory fields for taxonomy models. - Implemented a more robust MECE taxonomy structure. ## [0.3.3] - 2025-04-22 ### Added - Added `greenlet` as explicit dependency for SQLModel and aiosqlite - Added `markdown` as required dependency for documentation generation - Added `weasyprint` as optional dependency for PDF generation ### Changed - Updated MCP configuration documentation with clearer examples and best practices - Improved installation instructions with detailed environment setup steps - Enhanced database path configuration documentation ### Fixed - Fixed missing dependencies in PyPI package that caused installation issues - Improved dependency management to ensure all required packages are properly installed - Added `greenlet` as an explicit dependency required by `SQLModel` and `aiosqlite` for certain operations, resolving potential runtime errors. - Corrected database migration timestamps and cleaned up related comments. ## [0.3.2] - 2025-04-22 ### Added - Enhanced time service initialization with improved startup sequence - Added detailed database configuration options with better error handling - Improved database path configuration during installation process ### Changed - Updated version to 0.3.2 for PyPI release - Synchronized version numbers across VERSION file and pyproject.toml - Simplified database path logic for better maintainability - Enhanced documentation for database management, particularly around `--db-path` usage ### Fixed - Resolved time service initialization issues in high-load scenarios - Improved error handling for database configuration edge cases - Fixed inconsistencies in database path resolution ### Documentation - Added comprehensive database management documentation - Updated installation instructions with recommended database configuration methods - Improved clarity around Python integration examples ## [0.3.1] - 2025-04-21 ### Added - Added "Available Commands" section to README.md detailing the MCP commands. ### Changed - Refactored core PAELLA command functions (`paella_init`, `paella_list`, `paella_select`) for clarity and consistency. - Updated `pyproject.toml` and README badge to version 0.3.1. ### Fixed - Corrected integration tests (`test_paella.py`, `test_list_projects.py`) to align with the refactored PAELLA command signatures and return values. ## [0.3.0] - 2025-04-21 ### Changed - **BREAKING:** Refocused PAELLADOC as an implementation of Anthropic's Model Context Protocol (MCP), enabling AI-First development workflows primarily through LLM interaction rather than a direct CLI. - Updated README documentation to reflect the MCP focus, installation via pip, and usage through LLM interaction. ### Added - Initial Alembic database migration setup. - ChromaDB integration and vector store adapter (for potential future semantic capabilities). ### Fixed - Resolved various test failures related to monkeypatching, Alembic migrations, and Pydantic validation. - Corrected CI workflow dependencies (pytest-cov, chromadb). ## [0.2.2] - 2025-04-06 ### Added - Enhanced interactive documentation process with natural language flow - Improved file creation reliability in PAELLA command - More robust project memory tracking and updates ### Changed - Refined PAELLA command to enforce strict question sequence - Updated core rules structure for better modularity - Improved conversation workflows for better user experience ### Fixed - Fixed file creation issues when using PAELLA command - Resolved memory file update inconsistencies - Fixed command behavior when handling multilingual projects ## [0.2.1] - 2025-04-06 ### Added - New `run_continue.py` script to improve the CONTINUE command functionality ### Changed - Enhanced command interactivity for PAELLA and CONTINUE to present one question at a time - Refactored underlying scripts to use relative paths instead of absolute ones - Improved project detection in subdirectories for the CONTINUE command - Updated `run_generate_doc.py` script for better portability ### Fixed - Fixed command behavior to respect interactive configuration settings - Resolved project root detection issues - Fixed the CONTINUE script to display appropriate messages when no projects are available ## [0.2.0] - 2025-04-05 ### Added - **Dynamic Template-Based Menu System**: Replaced fixed menu with a dynamic menu generated from existing templates - **Improved Multilingual Support**: Implemented full support for both Spanish and English in documentation generation - New `enforce_fixed_menu.py` script modified to generate a dynamic menu from templates - Documentation file creation now uses templates as structural guides - Reorganized output instructions to save documentation to `/docs/generated/` - Improved integration between dynamic menu and documentation file generation ### Changed - GENERATE_DOC command configuration now supports additional templates - Generated files are now always saved in `/docs/generated/` while following template structure - Improved template organization and integration with the documentation system - System now respects user's language selection, without forcing Spanish or English ### Fixed - Fixed issues with documentation output file location - Solved inconsistency between menu and available templates - Improved documentation file saving process ## [0.1.0] - 2025-04-04 ### Breaking Changes - Implementation of repository documentation generation system (GENERATE_DOC) - Addition of code repository analysis and documentation extraction capabilities - Comprehensive reorganization of the `.cursor/rules` directory structure - Enhanced modularity with clearer separation of concerns - Addition of new interfaces and conversation workflows - Improved documentation of the system architecture ### Added - **Repository Analysis & Documentation**: New GENERATE_CONTEXT and GENERATE_DOC commands for code-to-documentation reverse engineering - Repository context extraction scripts and analysis tools - Interactive documentation generation from repository analysis - Repository content extraction to optimized text format - Architecture pattern detection and automatic documentation - Multi-step repository documentation process with user guidance - New help system in `core/help.mdc` - User interface definitions in `features/interfaces.mdc` - Enhanced conversation workflow in `features/conversation_workflow.mdc` - Detailed directory structure documentation in `DIRECTORY_STRUCTURE.md` - Feature mapping documentation in `feature_map.md` - Configuration file for conversation flows in `paelladoc_conversation_config.json` - New template directories: - `templates/conversation_flows/` for conversation configurations - `templates/methodologies/` for development methodologies - `templates/Product/` for main product documentation - `templates/scripts/` for template-specific scripts - `templates/selectors/` for selection guide templates - `templates/simplified_templates/` for simplified documentation - Improved organization of code generation templates ### Changed - Modular architecture with cleaner file organization - Enhanced product management capabilities - Improved code generation system - Better documentation of the directory structure - Enhanced mapping between features and their implementations - Reorganized template structure for better maintainability ### Fixed - Directory structure inconsistencies - Feature implementation mapping gaps - Template organization clarity - Documentation of system architecture