markitect-main/CHANGELOG.md

Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.9.0 - 2025-11-14

Added

• Plugin Infrastructure Foundation: Extended existing MarkiTect plugin system with RenderingEnginePlugin base class and RENDERING plugin type
• RenderingEngineManager: Complete plugin discovery and lifecycle management system for UI rendering engines
• RenderingConfig System: Asset management and deployment configuration for plugin engines
• TestDrive JSUI Plugin: Complete independent JavaScript UI plugin extracted from core system with standalone development environment
• Modular Component Architecture: Compass-positioned controls with clean JSON configuration interface for Python-JavaScript data transfer
• CLI Engine Parameter: Added --engine parameter to markitect md-render command with engine validation and mode compatibility checking
• Automatic Asset Deployment: Production-ready asset deployment to _markitect/plugins/ structure with 18 total assets (12 JS, 3 CSS, 3 images)
• ChatGPT Document Theme: New document theme with Inter font, 580px width, and #10a37f accent color with full CLI support (markitect md-render --theme chatgpt)
• Modular Theme System Architecture: File-based theme loading with YAML configuration and dynamic theme discovery
• Theme Directory Structure: Organized theme components (mode/, ui/, document/, branding/) for better maintainability
• Database Architecture Documentation: Comprehensive WORKSPACE_AND_DATABASES.md documenting workspace concepts and database purposes

Changed

• BREAKING: Edit mode now defaults to testdrive-jsui plugin instead of legacy edit mode
• Default Rendering Behavior: testdrive-jsui for edit/insert modes, standard for view mode with graceful fallback
• Asset Management Strategy: Automatic plugin asset deployment eliminates need for manual --ship-assets flag
• JavaScript Architecture: Clean separation between Python backend and JavaScript frontend with modular design
• Theme Loading System: Implemented dynamic theme discovery and loading with metadata preservation
• Test Suite Organization: Removed obsolete configuration CLI tests (490 lines) for cleaner codebase

Fixed

• JavaScript Loading Conflicts: Resolved const redeclaration errors with MARKITECT_STRICT_MODE implementation
• MarkitectMain Availability: Fixed proper main-updated.js loading and JavaScript syntax errors
• Plugin Asset Deployment: Directory structure preservation with development vs production deployment strategies
• Issue-facade Click Framework Bug: Resolved Sentinel bug in list command that was causing CLI failures
• Issue-facade Version Command: Fixed installation error preventing version command from working
• Test Isolation Issues: Improved test isolation with proper mocking to prevent cross-test interference
• Theme Color Assertions: Updated test assertions to work with new modular theme system

Migration Guide

• Existing Users: Edit mode will automatically use new testdrive-jsui plugin for enhanced experience
• Legacy Behavior: Use markitect md-render --engine standard --edit to access previous edit mode
• Asset Deployment: Plugin assets now deploy automatically - no manual --ship-assets flag required

0.8.0 - 2025-11-08

Added

• Setuptools-SCM Integration: Automatic version management system replacing manual version tracking
• Gitea Package Publishing: Complete CI/CD pipeline for automated package publishing to Gitea
• Enhanced Release Documentation: Comprehensive documentation for package building and release process

Changed

• Release Script Architecture: Modernized release workflow with setuptools-scm integration
• Makefile Release Targets: Updated release targets to support automated version management
• Package Building Process: Streamlined package creation with enhanced build targets

Removed

• Legacy Release Scripts: Removed obsolete release_simplified.py in favor of unified release.py

0.7.0 - 2025-11-08

Added

• Complete JavaScript Architecture Refactoring: Full TDD-driven modular architecture with SectionManager and DOMRenderer components
• Advanced Image Editor: Rebuilt with full drag-n-drop functionality and staging workflow
• Modular Component System: Extracted comprehensive JavaScript components for better maintainability
• Enhanced Edit Mode: Improved robustness and user experience with better reset functionality
• Insert Mode Protection: Implemented insert mode with heading protection and content display fixes
• Scroll Indicators: Added scroll indicators with disabled state styling
• Asset Shipping: Comprehensive asset shipping for md-render command

Fixed

• Reset Button Functionality: Implemented fully functional reset buttons for text and image sections
• Image Rendering: Fixed proper image rendering in modular architecture
• DOM Content Updates: Resolved DOM content updates and reset functionality
• Section Click Functionality: Enabled proper section click functionality for edit UI
• Modular Integration: Fixed integration of modular JavaScript architecture into application
• Button Functionality: Resolved accept, cancel, and reset button functionality issues
• Critical JavaScript Errors: Fixed errors preventing content rendering

Changed

• Edit Mode Organization: Continued efforts to reorganize edit mode for better robustness
• Example Directory Structure: Reorganized examples directory with topic-based subdirectories
• UI Panel Structure: Eliminated floating status panel above editor menu for cleaner interface

Maintenance

• TODO Cleanup: Cleaned up completed theme system refactor tasks

0.6.0 - 2025-10-28

Added

• Custom Status Modal System: Professional theme-consistent status dialogs replacing browser alerts with proper branding and accessibility
• HTML Generation Dogtag: Automatic attribution with timestamp and username linking for generated HTML documents
• Enhanced Link Navigation: All document links now open in new tabs without triggering edit mode for improved user experience
• Comprehensive UI Framework Documentation: Complete guide (UserInterfaceFramework.md) for consistent UI development patterns
• Database Integration: Added store_document method to CleanDocumentManager with proper front matter parsing
• Enhanced AST Processing: Improved title extraction from front matter and heading detection with cache file generation

Changed

• Complete Document Manager Cleanup: Removed 2000+ lines of legacy code while maintaining full backward compatibility
• Clean Architecture Implementation: DocumentManager now extends CleanDocumentManager with clean wrapper pattern
• Improved Error Handling: Enhanced validation and graceful error recovery throughout the system
• Standardized CSS Naming: Consistent class naming conventions across all UI components

Fixed

• Test Suite Compatibility: Updated all tests to work with clean implementation architecture
• JavaScript Syntax Issues: Resolved template literal and string escaping problems in generated HTML
• Link Behavior: Fixed issue where document links were incorrectly triggering edit mode
• Front Matter Parsing: Proper integration with FrontMatterParser for metadata extraction

Technical

• Added --nodogtag CLI option for clean output when attribution is not desired
• Enhanced ingest_file method with proper title extraction from front matter and headings
• Implemented theme-aware modal overlay patterns with proper CSS styling
• Fixed CSS escape sequences and JavaScript syntax validation issues

0.5.0 - 2025-10-26

Added

• Clean TDD-Driven Editor Architecture: Complete rewrite with object-oriented JavaScript architecture featuring Section, SectionManager, and DOMRenderer classes
• Enhanced Test Framework: Comprehensive testing framework with clean separation of concerns for robust development
• Multiple Concurrent Section Editing: Support for editing multiple sections simultaneously with intelligent management
• Intelligent Section Splitting: Advanced heading detection and section management capabilities
• Four-Layer Content Management: Sophisticated content state management (original, current, pending, editing layers)
• Enhanced Status Dialog: Repository info display showing version, git commit status, and actual save filename
• Elegant Slide-in Control Panel: Floating control panel for edit mode with improved UX
• Intelligent Auto-sizing Textarea: Optimal editing experience with smart textarea resizing
• Enhanced Empty Line Preservation: Better markdown structure preservation with automatic paragraph separation

Fixed

• Textarea Sizing and Font Preservation: Resolved sizing issues and maintained consistent font rendering
• Markdown Structure Preservation: Fixed roundtrip formatting issues in save functionality
• Section Duplication Prevention: Eliminated duplicate sections when saving edited content
• Section Position Preservation: Prevented unwanted section jumping during editing
• CSS Embedding Issues: Resolved import errors in HTML template generation
• Control Panel UX: Hidden control ribbon when panel is expanded for cleaner interface

Changed

• Action Semantics: Proper implementation of Accept, Cancel, and Reset operations
• Global Reset Functionality: Enhanced reset capabilities across the editor
• Makefile Organization: Reorganized installation targets for better user experience

Technical Improvements

• Complete legacy editor system replacement
• Test-driven development approach implementation
• Enhanced UI/UX with better section positioning
• Improved content management workflow

0.4.0 - 2025-10-25

Added

• feat: add comprehensive testing and error tracking for edit mode

Fixed

• fix: resolve md-render --edit functionality and add enhanced version tracking
• fix: resolve critical JavaScript syntax errors in md-render --edit
• fix: resolve md-ingest Path object conversion error

Other

• chore: clean up repository documentation files for release

0.3.0 - 2025-10-25

Added

• Kaizen-agentic Framework Integration: Integrated capability submodule for enhanced development workflow
• Test Reorganization System: Reorganized tests by capability with improved modularity
• Capability Inclusion Management: Comprehensive system for managing capability inclusions
• Todofile System: Implemented todofile system to replace NEXT.md for better task tracking

Changed

• Directory Organization: Logical separation and reorganization of project structure
• Historical File Organization: Cleaner structure with better file organization

0.2.0 - 2025-10-20

Added

• GraphQL Interface: Advanced querying capabilities with full GraphQL implementation
• Full-text Search: FTS5 backend integration for powerful search functionality
• Plugin Architecture: Extensible framework with comprehensive plugin support
• Query Paradigms: 14 different query paradigms for flexible data access
• Cost Management: Activity tracking and resource cost management
• Template Rendering: Template system with validation capabilities
• CLI Consolidation: Unified command-line interface
• Production Asset Management: Content-addressable storage system
• 17 Kaizen-agentic Agents: Integrated development agent ecosystem

Changed

• Performance Optimization: 60-85% performance improvement through system optimization
• Error Handling: Enterprise-grade error handling and recovery mechanisms
• Resource Management: Memory-efficient and scalable architecture

Fixed

• Cross-platform Validation: Comprehensive validation for Unix/Windows/macOS
• Type Safety: Enhanced type safety and security validation
• Test Coverage: 1983/1983 tests passing (100% success rate)

0.1.0 - 2025-10-15

Added

• Development Infrastructure: Comprehensive Makefile for development workflow
• Project Documentation: ProjectStatusDigest.md and ProjectDiary.md for tracking
• TDD Workspace System: Structured Test-Driven Development workflow implementation
• Issue Management: Gitea integration for issue tracking and management
• Virtual Environment Management: Enhanced venv detection and shell activation
• Wiki Integration: Submodule tracking for project documentation
• Core Repository Setup: Initial project structure and configuration

Changed

• Build System: Enhanced build targets with venv Python and PYTHONPATH support
• Target Naming: Renamed workspace targets to TDD Workspace with tdd- prefix