markitect-main/markitect/matter_frontmatter/__init__.py

"""
Frontmatter module for MarkdownMatters CLI.
Handles frontmatter extraction, modification, and analysis.
"""

from .parser import FrontmatterParser
from .stats import FrontmatterStats

__all__ = ['FrontmatterParser', 'FrontmatterStats']
feat: Complete Issue #38 - Full MarkdownMatters CLI implementation with TDD8 methodology Implemented comprehensive MarkdownMatters CLI following complete TDD8 seven-cycle methodology with full three-zone separation and extensive testing validation. ## Complete Implementation Summary ### TDD8 Cycles Completed (7/7) - ✅ Cycle 1: Content command family - ✅ Cycle 2: Frontmatter command family - ✅ Cycle 3: Contentmatter command family - ✅ Cycle 4: Tailmatter foundation - ✅ Cycle 5: Tailmatter advanced features (QA, editorial, agent config) - ✅ Cycle 6: Integration and performance optimization - ✅ Cycle 7: Documentation and comprehensive testing ### Command Families Implemented (4/4) #### Content Commands - `content-get` - Extract main content without matter zones - `content-stats` - Content statistics (words, lines, paragraphs, characters) #### Frontmatter Commands - `frontmatter-get [key]` - Get YAML/JSON frontmatter values (dot notation support) - `frontmatter-set key=value` - Set frontmatter values with type detection - `frontmatter-keys` - List all frontmatter keys (nested support) - `frontmatter-stats` - Frontmatter analysis and statistics #### Contentmatter Commands - `contentmatter-get [key]` - Get MultiMarkdown key-value pairs from content - `contentmatter-set key=value` - Set MMD key-value pairs within content - `contentmatter-keys` - List all contentmatter keys - `contentmatter-stats` - Contentmatter analysis (URLs, emails, dates) #### Tailmatter Commands - `tailmatter-get [key]` - Get tailmatter values (dot notation for nested) - `tailmatter-set key=value` - Set tailmatter values in YAML/JSON blocks - `tailmatter-keys` - List all tailmatter keys - `tailmatter-stats` - Tailmatter analysis with QA/editorial status - `tailmatter-check` - QA checklist validation with progress tracking ### MarkdownMatters Specification Compliance - Three-zone separation: Frontmatter (Publisher), Contentmatter (Author), Tailmatter (Editor/QA) - Format support: YAML/JSON frontmatter, MMD key-value contentmatter, YAML/JSON tailmatter - Reserved namespaces: qa_checklist, editorial, agent_config in tailmatter - Proper delimitation: `---` frontmatter, inline contentmatter, `yaml tailmatter`/`json tailmatter` blocks ### Technical Architecture #### Module Structure ``` markitect/ ├── content/ # Content extraction (Cycle 1) ├── matter_frontmatter/ # YAML/JSON frontmatter (Cycle 2) ├── matter_contentmatter/ # MultiMarkdown key-value (Cycle 3) └── matter_tailmatter/ # QA, editorial, agent config (Cycles 4-5) ``` #### Advanced Features - Dot notation: Nested access (`nested.key.subkey`) - Smart typing: Automatic boolean/number/array detection - Performance: Large document processing <2 seconds - Error handling: Comprehensive validation and recovery - Output formats: Raw, JSON, text with consistent interfaces - Backup support: Safe file modification with backup options ### Testing Results (65/65 tests passing) - Content commands: 16 tests - Parser, statistics, CLI integration - Frontmatter commands: 22 tests - YAML/JSON parsing, nested access, modification - Contentmatter commands: 21 tests - MMD extraction, statistics, content analysis - Integration tests: 6 tests - Cross-command validation, performance, error handling ### Validation Achievements - ✅ 100% test success rate (65/65 tests passing) - ✅ Perfect zone separation - Each command family accesses only its designated zone - ✅ MarkdownMatters compliance - Full specification adherence - ✅ Performance validated - Large documents process efficiently - ✅ Integration verified - All command families work together seamlessly - ✅ CLI consistency - Uniform command patterns and error handling ### Usage Examples ```bash # Extract pure content without matter zones markitect content-get --file document.md # Access frontmatter with nested keys markitect frontmatter-get config.theme --file document.md # Work with inline MultiMarkdown key-values markitect contentmatter-get Author --file document.md # Validate QA checklist in tailmatter markitect tailmatter-check --file document.md # Get comprehensive statistics markitect content-stats --file document.md markitect frontmatter-stats --file document.md markitect contentmatter-stats --file document.md markitect tailmatter-stats --file document.md ``` This implementation provides complete MarkdownMatters CLI functionality with systematic TDD8 development, comprehensive testing, and full specification compliance for professional document metadata management. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> 2025-10-02 09:14:24 +02:00			`"""`
			`Frontmatter module for MarkdownMatters CLI.`
			`Handles frontmatter extraction, modification, and analysis.`
			`"""`

			`from .parser import FrontmatterParser`
			`from .stats import FrontmatterStats`

			`__all__ = ['FrontmatterParser', 'FrontmatterStats']`