3 Commits

Author	SHA1	Message	Date
tegwick	2836ae14de	docs: add semantic validation guide to schema management ... Adds comprehensive documentation for semantic document validation: New Section: Document Validation (Semantic) - Explains structural vs semantic validation - Lists what is validated (sections, patterns, quality metrics) - Shows validation output format - Provides common validation scenarios with examples Content: - How to validate documents against schemas - Section classification enforcement (required, recommended, etc.) - Content pattern matching (required, forbidden, discouraged) - Quality metrics (word counts, sentence counts) - Usage examples with --semantic, --strict flags - Error and warning examples Location: docs/SCHEMA_MANAGEMENT_GUIDE.md (after Schema Validation section) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-01-06 03:28:28 +01:00
tegwick	3003b9b8da	chore: archive completed schema-of-schemas implementation ... Moved schema-of-schemas planning artifacts from roadmap to history with datestamp prefix, marking completion of all 6 implementation phases. **Changes:** - Moved roadmap/schema-of-schemas/ → history/2026-01-05-schema-of-schemas/ - Updated all documentation references to new location - Marked implementation as completed in TODO.md - Updated CHANGELOG.md to reflect archived status **Implementation Summary:** All 6 phases completed successfully: - Phase 1: Filename validation (50 tests) - Phase 2: Markdown schema loader (35 tests) - Phase 3: Schema-for-schemas metaschema (12 tests) - Phase 4: Schema migration (2 migrated, 3 deleted) - Phase 5: CLI enhancements (multi-schema validation) - Phase 6: Integration testing and documentation **Deliverables:** - 97 unit tests (100% passing) - 4 production schemas in registry - Comprehensive user documentation - Updated examples (manpages, terminology) - Complete schema management system The schema-of-schemas topic is now complete and archived for historical reference. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-01-05 14:13:48 +01:00
tegwick	f19a88f1d5	docs: complete Phase 6 - integration testing and documentation ... Completed final phase of Schema-of-Schemas implementation with comprehensive testing and user documentation. **Integration Testing:** - All 97 unit tests passing (50 naming + 35 loader + 12 metaschema) - End-to-end workflow testing: * Schema creation and validation * Schema ingestion into registry * Numbered schema listing * Single schema validation (number, filename, path) * Batch validation (ranges, lists, --all) * Schema deletion and cleanup **Documentation:** - Created comprehensive SCHEMA_MANAGEMENT_GUIDE.md - Quick start guide with templates - Complete command reference for all schema commands - Common workflows and use cases - Best practices and troubleshooting - Advanced usage patterns - Future enhancement notes **Phase Summary:** - Schema-of-Schemas implementation complete (6 phases) - Fully functional schema management system - 97 tests with 100% pass rate - 4 comprehensive documentation files: * SCHEMA_MANAGEMENT_GUIDE.md (usage) * SCHEMA_NAMING_SPEC.md (naming conventions) * SCHEMA_LOADER_GUIDE.md (markdown schemas) * schema-schema-v1.0.md (metaschema reference) This completes the Schema-of-Schemas implementation, providing a robust, well-tested, and well-documented schema management system for MarkiTect. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-01-05 11:41:33 +01:00