2 Commits

Author	SHA1	Message	Date
tegwick	1358ca17ec	refactor: Remove circular test dependencies and meta-testing anti-patterns ... Clean up test infrastructure by removing problematic tests that create circular dependencies and execute the test suite from within tests. Key removals: - Delete test_issue_57_test_efficiency_improvements.py entirely (12 tests) - Contained tests that ran `make test-tdd`, `make test-status` etc. - Created circular dependencies where tests execute the entire test suite - Violated separation of concerns between testing and test infrastructure - Remove self-execution blocks from 11 test files - Eliminated `if __name__ == '__main__': pytest.main([__file__, '-v'])` patterns - Prevents confusion and potential circular execution paths - Test files should be run via pytest, not as standalone scripts Test Infrastructure Improvements: - Reduced test count from 701 to 689 tests (removed 12 problematic tests) - Eliminated subprocess calls to `make test-*` commands from within tests - Removed `pytest.main()` calls that could cause circular execution - Maintained clean separation between test infrastructure and actual tests Impact: - No more tests testing tests (circular dependency elimination) - Cleaner test execution without subprocess complexity - Proper test isolation and independence - Faster and more reliable test runs The proper way to test infrastructure is to test the underlying functions directly, not to execute the entire test suite from within a test. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-01 21:05:36 +02:00
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