3 Commits

Author	SHA1	Message	Date
tegwick	0f37900222	feat: Complete Issue #52 - Capture actual heading text in schemas ... Implement comprehensive heading text capture functionality that allows schemas to enforce specific heading text requirements through enum constraints: • New CLI option: --capture-heading-text flag for exact text constraints • Schema generation with heading text as enum constraints (not just structure) • Advanced validation engine that enforces heading text requirements • Metaschema extension: x-markitect-heading-text-capture marker • Full integration with Issue #51 outline mode capabilities • Comprehensive error reporting for heading text mismatches • Complete backward compatibility with existing schema generation Technical implementation: - Extended SchemaGenerator with capture_heading_text parameter - Enhanced validation system to check enum constraints on heading content - Added _validate_heading_text_constraints_with_errors for detailed reporting - Integrated with existing metaschema validation from Issue #50 - Preserved document order of headings in enum constraints Key features: - Schemas can now specify required heading text via enum constraints - Validation rejects documents with incorrect heading text - Detailed error messages show expected vs actual heading text - Works seamlessly with outline mode depth controls - Maintains 100% compatibility with 513 existing tests Usage examples: markitect schema-generate --capture-heading-text document.md markitect schema-generate --mode outline --capture-heading-text --depth 2 document.md 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-01 08:03:11 +02:00
tegwick	b5f510f9c7	feat: Complete Issue #51 - Add outline mode to schema generation ... Implement comprehensive outline mode functionality for schema generation with: • New CLI options: --mode outline, --depth parameter, --outfile alias • Schema title format: "Schema from file.md" instead of "Schema for file.md" • Metaschema extensions: x-markitect-outline-mode, x-markitect-outline-depth • Depth control with validation (--depth must be >= 1) • Parameter conflict detection and error handling • Full backward compatibility with existing --max-depth option • Comprehensive test coverage (10 new tests, all passing) • Enhanced CLI help documentation with examples Technical implementation: - Extended SchemaGenerator.generate_schema_from_file() with mode/outline_depth parameters - Updated CLI command with new options and parameter validation - Maintained 100% compatibility with existing 493 tests - Integrated with Issue #50 metaschema validation Usage examples: markitect schema-generate --mode outline document.md markitect schema-generate --mode outline --depth 3 --outfile schema.json document.md 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-01 02:59:40 +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