Rhoe Language Specification v0.9.0¶
Status¶
- Normative baseline: This repo root is the authoritative live baseline for Rhoe Language version
0.9.0. - Authority order:
- Specification conventions, versioning policy, and normative prose in this repo
- Machine artifacts, registries, fixtures, reference packs, and compiled references in this repo when they conform to the prose
- Normative decision: The canonical root is
Artifact; the canonical version string for this baseline is0.9.0.
Purpose¶
- This repo is the self-contained, machine-accompanied public baseline for Rhoe Language
0.9.0. - It uses a
Part 0 / Part 1 / Part 2organization with a clear authority gradient: - Part 0 defines ontology, canonical serialization, normalization, and registries.
- Part 1 defines humane source surfaces.
- Part 2 defines realization, runtime, conformance, and migration.
rhoemdremains the primary humane author surface.rhoedslremains the closest humane structural mirror of the canonical AST.RhoeJSONremains the canonical serialized notation of the canonical AST.RhoeTypst,RhoeLaTeX, andRhoeHTMLare official Part 2 near-AST target-source surfaces.
Reading Order¶
Public Specification Front Matter¶
Part 0 — Foundation¶
part-0-foundation/00-part-0-index.mdpart-0-foundation/01-language-identity-and-versioning.mdpart-0-foundation/02-abstract-ontology-and-root-artifact.mdpart-0-foundation/03-canonical-serialization-and-validation.mdpart-0-foundation/04-terminology-taxonomy-and-authority-model.mdpart-0-foundation/05-processing-pipeline-and-normalization.mdpart-0-foundation/06-semantic-attributes-brand-and-critic-doctrine.mdpart-0-foundation/07-stable-identity-numbering-and-cross-references.mdpart-0-foundation/08-source-surfaces-notation-islands-and-surface-equivalence.mdpart-0-foundation/09-core-registries.mdpart-0-foundation/10-artifact-workbench-contract-authority.md
Part 1 — Author Surfaces¶
part-1-author-surfaces/00-part-1-index.mdpart-1-author-surfaces/10-rhoemd-overview-and-authoring-doctrine.mdpart-1-author-surfaces/11-rhoemd-core-block-and-inline-syntax.mdpart-1-author-surfaces/12-rhoemd-matter-carriers-and-structural-directives.mdpart-1-author-surfaces/13-rhoemd-stageframe-surface-and-compatibility.mdpart-1-author-surfaces/14-rhoemd-nonstage-carrier-surfaces.mdpart-1-author-surfaces/15-rhoemd-formal-grammar-and-tokenization.mdpart-1-author-surfaces/16-rhoedsl-reference.mdpart-1-author-surfaces/17-surface-equivalence-roundtripping-and-lowering.md
Part 2 — Realization and Runtime¶
part-2-realization-runtime/00-part-2-index.mdpart-2-realization-runtime/20-target-realization-and-emission-doctrine.mdpart-2-realization-runtime/20a-secondary-near-ast-surface-doctrine.mdpart-2-realization-runtime/20b-rhoetypst-near-ast-contract.mdpart-2-realization-runtime/20c-rhoelatex-near-ast-contract.mdpart-2-realization-runtime/20d-rhoehtml-near-ast-contract.mdpart-2-realization-runtime/20e-target-profiles-and-realization-pack-contracts.mdpart-2-realization-runtime/21-extension-and-composition-grammar-pack-architecture.mdpart-2-realization-runtime/22-computable-blocks-and-sandboxing.mdpart-2-realization-runtime/23-project-orchestration-build-and-pack-discovery.mdpart-2-realization-runtime/24-conformance-validation-and-fixture-suites.mdpart-2-realization-runtime/25-migration-compatibility-and-version-bridges.md
Machine Artifacts¶
machine/registries/rhoe-language-spec-release.jsonmachine/schemas/rhoejson-canonical-v0_9.schema.jsonmachine/schemas/composition-grammar-pack-manifest-v0_9.schema.jsonmachine/schemas/realization-pack-manifest-v0_9.schema.jsonmachine/schemas/fixture-suite-manifest-v0_9.schema.jsonmachine/grammars/rhoemd-v0_9.pegmachine/grammars/rhoemd-v0_9.ebnfmachine/grammars/rhoedsl-v0_9.ebnfmachine/grammars/README.mdmachine/registries/machine/examples/stage-default.composition-grammar-pack.json
Reference Packs¶
Fixtures¶
Generated Release Summary¶
Validation Entry Point¶
Architectural Summary¶
- One language, one canonical AST.
Artifactis the universal root.carrierArchetypeis the primary carrier discriminator.MatterEnvelopewithfrontMatter,mainMatter, andbackMatteris universal.Section,Subsection, andSubSubsectionare the universal nesting spine.stageFrameis the first deeply elaborated carrier specialization.Frameis the canonical stage-frame unit.- Canonical
rhoemdis carrier-aware and frame-primary. :::slide,:::slide-section,%%%,%%,%, andshell-grammar:remain supported as deprecated compatibility inputs.
Versioning Note¶
- The
0.9.0label marks this baseline as pre-1.0public release work. RhoeLanguageis now the active authority home for the0.9.0baseline.
Validation Authority¶
- The executable validation authority for this baseline is
scripts/validate-spec-v0_9.sh, wrapped byscripts/verify-cutover.sh. - Generated release-pack metadata is rebuilt by
scripts/build-release-pack.py.