2 Commits

Author	SHA1	Message	Date
tegwick	0acde1e840	feat: Complete Issue #5 - Schema Generation Foundation for arc42 Architecture Documentation ... CRITICAL MILESTONE: Establish schema-driven architecture foundation that unlocks the entire pathway to HolyGrailRequirement - intelligent arc42 architecture documentation with AI-supported plan-actual comparison capabilities. Major Components Implemented: 🎯 SCHEMA GENERATION SERVICE: • SchemaGenerator class with sophisticated AST analysis capabilities • Depth-limited heading extraction for arc42 section-specific schemas • Comprehensive structural element detection (headings, paragraphs, lists, code blocks, etc.) • JSON Schema Draft 7 compliant output with proper validation metadata • Robust error handling with domain-specific exceptions (FileNotFoundError, InvalidDepthError) 🖥️ CLI INTEGRATION: • generate-schema command with full argument and option support • Multiple output formats (JSON, YAML) with stdout or file output • Configurable depth limiting for architectural document analysis • User-friendly summaries and progress feedback • Integration with existing CLI framework and error handling patterns 📊 COMPREHENSIVE TESTING: • 6 comprehensive test scenarios covering core functionality and edge cases • Perfect integration with architectural test system (71 service layer tests passing) • Test coverage for schema generation, depth limiting, error handling, and JSON compliance • Architectural layer L4 (Service) test placement following reverse dependency principles 🏗️ STRATEGIC ARCHITECTURE: • Leverages existing AST processing infrastructure for maximum efficiency • Builds on proven markdown-it parsing with intelligent caching • Seamless integration with existing CLI framework and configuration system • Foundation for Issues #7 (Schema Validation) and #8 (Validation Errors) Technical Excellence: - Full JSON Schema Draft 7 specification compliance for validator compatibility - Sophisticated AST token analysis with structural pattern recognition - Configurable depth filtering essential for arc42 template compliance - Comprehensive metadata extraction for architectural analysis - Robust exception handling with actionable error messages Strategic Value: - 🎯 33% completion of critical path Phase 1 (Schema Foundation) - 🔑 Unlocks schema validation and error reporting capabilities - 🏛️ Essential building block for arc42 architectural documentation intelligence - 🚀 Direct pathway to AI-supported plan-actual comparison capabilities This implementation transforms MarkiTect from advanced markdown processor toward intelligent architecture documentation platform, establishing the schema-driven foundation critical for achieving the HolyGrailRequirement of arc42 compliance with AI intelligence. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-29 14:53:05 +02:00
tegwick	bbc6192fe1	refactor: Standardize error handling patterns across codebase ... Comprehensive error handling improvements addressing inconsistent patterns: • Created markitect/exceptions.py with complete domain-specific exception hierarchy - MarkitectError base class with context and cause chaining support - Specific exceptions for Document, AST, Cache, Database, Schema operations - Built-in logging and context preservation • Fixed overly broad exception handling in tddai modules: - issue_fetcher.py: Replace generic Exception with specific Gitea errors - project_manager.py: Proper error translation with context preservation - coverage_analyzer.py: Replace silent suppression with logging • Enhanced cache_service.py error handling: - Specific OSError/PermissionError handling for file operations - Logging integration for unexpected errors - Preserved error collection and reporting • Implemented proper exception chaining patterns: - All error translations use `raise ... from e` for debugging - Preserved original exception context and stack traces - Added docstring declarations of raised exceptions • Benefits: - Eliminates silent error suppression and debugging black holes - Provides specific, actionable error messages - Preserves full error context for troubleshooting - Establishes consistent patterns for future development Resolves issue #21: Error handling standardization 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-09-26 16:35:13 +02:00