Add schema-spec alignment, documentation, and tooling improvements#19
Merged
gvonness-apolitical merged 1 commit intomainfrom Feb 1, 2026
Merged
Add schema-spec alignment, documentation, and tooling improvements#19gvonness-apolitical merged 1 commit intomainfrom
gvonness-apolitical merged 1 commit intomainfrom
Conversation
Schema Changes: - Add presentation:reference block and indexMark to presentation schema - Add semantic property to blockAttributes in content schema - Add extension config support to manifest schema - Expand presentation schema with layout, print, master pages, typography - Add code syntax highlighting tokens to codeBlock schema - Create legal extension schema (Table of Authorities, citations) Documentation: - Expand terminology glossary in 00-introduction.md - Add hashing boundary summary table to 06-document-hashing.md - Add syntax highlighting section to 03-content-blocks.md - Create legal extension spec with citation formats - Rename archive files with topic summaries Tooling: - Add spec-schema sync checker script - Add cross-reference validator script - Add document template generator script - Update validation scripts for new dependencies Examples: - Add presentation-document example with book layout
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR implements a comprehensive cleanup and consistency plan for the Codex specification:
Changes
Schema Changes
presentation:referenceblock to presentation schemaindexMarkto presentation schema (for index generation)semanticproperty toblockAttributesin content schemaconfigproperty to extension definitions in manifest schemacodeBlockschemalegal.schema.jsonfor Table of Authorities and legal citationsDocumentation Improvements
00-introduction.mdwith clear definitions for Block, Mark, Annotation, Element, etc.06-document-hashing.md03-content-blocks.mdspec/extensions/legal/README.md)New Tooling
scripts/check-spec-schema-sync.ts- Detects drift between spec documentation and schemasscripts/validate-cross-refs.ts- Validates internal references in spec markdownscripts/generate-template.ts- Generates minimal valid documents for extension combinationsExamples
examples/presentation-document/demonstrating master pages, typography, multi-column layout, running headers/footersTest plan