From 3003b9b8da215458fa66719083dd6ec9a15ab1e1 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 5 Jan 2026 14:13:48 +0100 Subject: [PATCH] chore: archive completed schema-of-schemas implementation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- CHANGELOG.md | 9 +++++---- TODO.md | 4 ++-- docs/SCHEMA_MANAGEMENT_GUIDE.md | 5 +++-- .../2026-01-05-schema-of-schemas}/README.md | 0 .../2026-01-05-schema-of-schemas}/SCHEMA_LOADER_GUIDE.md | 0 .../SCHEMA_MANAGEMENT_PROPOSAL.md | 0 .../SCHEMA_MANAGEMENT_SUMMARY.md | 0 .../2026-01-05-schema-of-schemas}/SCHEMA_NAMING_SPEC.md | 0 .../2026-01-05-schema-of-schemas}/WORKPLAN.md | 0 markitect/schemas/manpage-schema-v1.0.md | 5 +++-- markitect/schemas/schema-schema-v1.0.md | 7 ++++--- 11 files changed, 17 insertions(+), 13 deletions(-) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/README.md (100%) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/SCHEMA_LOADER_GUIDE.md (100%) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/SCHEMA_MANAGEMENT_PROPOSAL.md (100%) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/SCHEMA_MANAGEMENT_SUMMARY.md (100%) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/SCHEMA_NAMING_SPEC.md (100%) rename {roadmap/schema-of-schemas => history/2026-01-05-schema-of-schemas}/WORKPLAN.md (100%) diff --git a/CHANGELOG.md b/CHANGELOG.md index 070f802c..b81e42d2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,7 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Markdown-first schema format with embedded JSON (documentation + schema in one file) - Schema catalog (`markitect/schemas/schema-catalog.yaml`) for metadata and discovery - Terminology validation example (`examples/terminology/`) demonstrating schema usage beyond manpages - - Schema-for-schemas workplan in `roadmap/schema-of-schemas/` directory + - Schema-of-schemas implementation archived in `history/2026-01-05-schema-of-schemas/` - **Enhanced schema-list Command**: Now displays numbered references in all output formats for easy selection - Simple format: `[1] schema-name.md` prefix for each schema - Table format: `#` column as first column @@ -34,9 +34,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Enhanced control panel UI with better resize handle positioning for improved user interaction ### Changed -- **Directory Reorganization**: Renamed `todo/` → `roadmap/` for better organization of planning documents - - Created `roadmap/schema-of-schemas/` subdirectory for schema management planning artifacts - - Moved schema management proposals and workplan to dedicated directory +- **Directory Reorganization**: + - Renamed `todo/` → `roadmap/` for better organization of planning documents + - Completed schema-of-schemas implementation archived to `history/2026-01-05-schema-of-schemas/` + - Moved completed planning artifacts to history for reference - Refactored contents control architecture to use base class pattern properly for better code organization - Updated all file references and paths to point to single source of truth in capabilities/testdrive-jsui/js/controls/ directory diff --git a/TODO.md b/TODO.md index 33b9b50f..f58f345d 100644 --- a/TODO.md +++ b/TODO.md @@ -14,8 +14,8 @@ This section is for tasks currently being discussed with or worked on by the cod ### Schema-of-Schemas Implementation (Active - Phase 4) -**Status:** Phase 4 - Schema Migration (Completed ✅) -**Workplan:** See `roadmap/schema-of-schemas/WORKPLAN.md` +**Status:** Completed (All 6 Phases ✅) +**Workplan:** See `history/2026-01-05-schema-of-schemas/WORKPLAN.md` (archived) **Current Goals:** 1. ✅ Establish naming convention: `{domain}-schema-v{major}.{minor}.md` diff --git a/docs/SCHEMA_MANAGEMENT_GUIDE.md b/docs/SCHEMA_MANAGEMENT_GUIDE.md index 3deb724f..c8ce99f6 100644 --- a/docs/SCHEMA_MANAGEMENT_GUIDE.md +++ b/docs/SCHEMA_MANAGEMENT_GUIDE.md @@ -387,9 +387,10 @@ Planned features: ## Related Documentation -- [Schema Naming Specification](../roadmap/schema-of-schemas/SCHEMA_NAMING_SPEC.md) -- [Schema Loader Guide](../roadmap/schema-of-schemas/SCHEMA_LOADER_GUIDE.md) +- [Schema Naming Specification](../history/2026-01-05-schema-of-schemas/SCHEMA_NAMING_SPEC.md) +- [Schema Loader Guide](../history/2026-01-05-schema-of-schemas/SCHEMA_LOADER_GUIDE.md) - [Metaschema Reference](../markitect/schemas/schema-schema-v1.0.md) +- [Implementation Workplan](../history/2026-01-05-schema-of-schemas/WORKPLAN.md) (archived) ## Support diff --git a/roadmap/schema-of-schemas/README.md b/history/2026-01-05-schema-of-schemas/README.md similarity index 100% rename from roadmap/schema-of-schemas/README.md rename to history/2026-01-05-schema-of-schemas/README.md diff --git a/roadmap/schema-of-schemas/SCHEMA_LOADER_GUIDE.md b/history/2026-01-05-schema-of-schemas/SCHEMA_LOADER_GUIDE.md similarity index 100% rename from roadmap/schema-of-schemas/SCHEMA_LOADER_GUIDE.md rename to history/2026-01-05-schema-of-schemas/SCHEMA_LOADER_GUIDE.md diff --git a/roadmap/schema-of-schemas/SCHEMA_MANAGEMENT_PROPOSAL.md b/history/2026-01-05-schema-of-schemas/SCHEMA_MANAGEMENT_PROPOSAL.md similarity index 100% rename from roadmap/schema-of-schemas/SCHEMA_MANAGEMENT_PROPOSAL.md rename to history/2026-01-05-schema-of-schemas/SCHEMA_MANAGEMENT_PROPOSAL.md diff --git a/roadmap/schema-of-schemas/SCHEMA_MANAGEMENT_SUMMARY.md b/history/2026-01-05-schema-of-schemas/SCHEMA_MANAGEMENT_SUMMARY.md similarity index 100% rename from roadmap/schema-of-schemas/SCHEMA_MANAGEMENT_SUMMARY.md rename to history/2026-01-05-schema-of-schemas/SCHEMA_MANAGEMENT_SUMMARY.md diff --git a/roadmap/schema-of-schemas/SCHEMA_NAMING_SPEC.md b/history/2026-01-05-schema-of-schemas/SCHEMA_NAMING_SPEC.md similarity index 100% rename from roadmap/schema-of-schemas/SCHEMA_NAMING_SPEC.md rename to history/2026-01-05-schema-of-schemas/SCHEMA_NAMING_SPEC.md diff --git a/roadmap/schema-of-schemas/WORKPLAN.md b/history/2026-01-05-schema-of-schemas/WORKPLAN.md similarity index 100% rename from roadmap/schema-of-schemas/WORKPLAN.md rename to history/2026-01-05-schema-of-schemas/WORKPLAN.md diff --git a/markitect/schemas/manpage-schema-v1.0.md b/markitect/schemas/manpage-schema-v1.0.md index ce0826b0..ef912e76 100644 --- a/markitect/schemas/manpage-schema-v1.0.md +++ b/markitect/schemas/manpage-schema-v1.0.md @@ -328,6 +328,7 @@ markitect validate my-command.1.md --schema manpage-schema-v1.0 ## Related Documentation -- [Schema Naming Specification](../../roadmap/schema-of-schemas/SCHEMA_NAMING_SPEC.md) -- [Schema Management Workplan](../../roadmap/schema-of-schemas/WORKPLAN.md) +- [Schema Naming Specification](../../history/2026-01-05-schema-of-schemas/SCHEMA_NAMING_SPEC.md) +- [Schema Management Workplan](../../history/2026-01-05-schema-of-schemas/WORKPLAN.md) (archived) +- [Schema Management Guide](../../docs/SCHEMA_MANAGEMENT_GUIDE.md) - [MarkiTect Documentation](../../README.md) diff --git a/markitect/schemas/schema-schema-v1.0.md b/markitect/schemas/schema-schema-v1.0.md index 8e464932..d930a21e 100644 --- a/markitect/schemas/schema-schema-v1.0.md +++ b/markitect/schemas/schema-schema-v1.0.md @@ -514,6 +514,7 @@ Valid values: `required`, `recommended`, `optional`, `discouraged`, `improper` ## Related Documentation -- [Schema Naming Specification](../../roadmap/schema-of-schemas/SCHEMA_NAMING_SPEC.md) -- [Schema Loader Guide](../../roadmap/schema-of-schemas/SCHEMA_LOADER_GUIDE.md) -- [Schema Management Workplan](../../roadmap/schema-of-schemas/WORKPLAN.md) +- [Schema Naming Specification](../../history/2026-01-05-schema-of-schemas/SCHEMA_NAMING_SPEC.md) +- [Schema Loader Guide](../../history/2026-01-05-schema-of-schemas/SCHEMA_LOADER_GUIDE.md) +- [Schema Management Workplan](../../history/2026-01-05-schema-of-schemas/WORKPLAN.md) (archived) +- [Schema Management Guide](../../docs/SCHEMA_MANAGEMENT_GUIDE.md) (user documentation)