From f185d16ddbac93d596a772eb7d6b2a3b88059484 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 31 Aug 2026 15:24:11 +0000
Subject: [PATCH] ogar-vocab: mint the 9 domain-reference-tree blocks
 (0x90..0x9A minus the two aliases)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Operator ruling 2026-08-31: "mint die 9 bloecke". Read off
MedCare-rs data/config/domain_classids.tsv, which has carried the
allocation since 2026-08-21 with status "erbeten".

The defect it closes: all eight medcare domains live in ONE block, 0x03XX
(Ontology). The high byte therefore says only "biomedical reference" and
not WHICH domain — so a compartment has to be looked up from the
vocabulary classid instead of read off the key, and a reasoning path that
leaves a compartment and bends back into it (a horseshoe U-turn) is
invisible at the address. With the tree, HIGH byte = compartment and LOW
byte = vocabulary carried 1:1 from 0x03: mondo 0x0301 -> 0x9101, loinc
0x0307 -> 0x9407, atc 0x030B -> 0x970B. The compartment becomes
classid >> 24, a byte compare.

Minted: 0x90 Reference (tree root) · 0x91 Disease · 0x92 Phenomenology ·
0x94 Lab · 0x95 Imaging · 0x96 BiologicalProcess · 0x97 Substance ·
0x98 Procedure · 0x9A Form.

NOT minted, deliberately: 0x93 anatomy and 0x99 genetics are ALIASES onto
the existing authorities 0x0A Anatomy and 0x0E Genetics (ogar-fma and
ogar-cpic/q2 already consume those) — minting them here would be a second
source of truth for one domain. 0x9E stays unclaimed: it is has_phenotype
in ogar-ro's PREDICATE space, a different axis that overlaps these numbers.

ZERO codebook rows, as with Ontology: the tree reserves ADDRESSES; the
concepts stay plug-and-play in their producers. That is the same posture
the 0x03XX revert restored this morning, applied to the successor blocks.

Two-sided falsifiers: the nine resolve AND the three lookalikes
(0x93/0x99/0x9E) stay Unassigned; the tree carries no codebook rows, with
an anti-vacuity check that the codebook is populated at all.

ogar-vocab 166; workspace green; clippy 0, fmt clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PFnYKqw6d7TTiB9cT8eFdK
---
 crates/ogar-encryption/src/lib.rs           |   2 +-
 crates/ogar-render-askama/src/field_view.rs |  13 +-
 crates/ogar-vocab/src/lib.rs                | 177 ++++++++++++++++++++
 3 files changed, 187 insertions(+), 5 deletions(-)

diff --git a/crates/ogar-encryption/src/lib.rs b/crates/ogar-encryption/src/lib.rs
index 41a4c9f7..ebebb1ef 100644
--- a/crates/ogar-encryption/src/lib.rs
+++ b/crates/ogar-encryption/src/lib.rs
@@ -62,7 +62,7 @@ pub use encryption::{aead, envelope, hash, kdf, sign};
 // ── Root-level convenience aliases, mirrored from `encryption`'s own root
 // re-exports (`envelope::{seal, open}` plus the envelope's error/parameter
 // types), so callers that used the upstream crate's short paths keep them.
-pub use encryption::{open, seal, EnvelopeError, KdfParams};
+pub use encryption::{EnvelopeError, KdfParams, open, seal};
 
 // ── The platform-CSPRNG-unavailable error, mirrored from `encryption`'s
 // crate root.
diff --git a/crates/ogar-render-askama/src/field_view.rs b/crates/ogar-render-askama/src/field_view.rs
index c5f1d286..9fbd6fda 100644
--- a/crates/ogar-render-askama/src/field_view.rs
+++ b/crates/ogar-render-askama/src/field_view.rs
@@ -217,7 +217,10 @@ mod tests {
 
         // The surface is addressed by class + concept + key.
         assert!(src.contains("data-class-id=\"0x0102\""), "{src}");
-        assert!(src.contains("data-concept=\"commercial_document\""), "{src}");
+        assert!(
+            src.contains("data-concept=\"commercial_document\""),
+            "{src}"
+        );
         assert!(src.contains("data-key=\"0801000301020304\""), "{src}");
         // Each field carries its POSITION (layout address) — including the
         // wide position past 63.
@@ -265,7 +268,10 @@ mod tests {
 
         assert!(!src.contains("<script>alert('label')"), "label raw:\n{src}");
         assert!(!src.contains("<img src=x onerror"), "value raw:\n{src}");
-        assert!(!src.contains("<script>alert('action')"), "action raw:\n{src}");
+        assert!(
+            !src.contains("<script>alert('action')"),
+            "action raw:\n{src}"
+        );
         assert!(!src.contains("<title-xss>"), "title raw:\n{src}");
         assert!(!src.contains("<concept-xss>"), "concept raw:\n{src}");
         // The escaped form is present (quote encoding varies by askama
@@ -275,8 +281,7 @@ mod tests {
 
     #[test]
     fn empty_actions_omit_the_nav() {
-        let src =
-            render_field_view(1, "c", "00", "T", &sample_fields(), &[]).unwrap();
+        let src = render_field_view(1, "c", "00", "T", &sample_fields(), &[]).unwrap();
         assert!(
             !src.contains("fieldview-actions"),
             "no action nav when there are no actions:\n{src}"
diff --git a/crates/ogar-vocab/src/lib.rs b/crates/ogar-vocab/src/lib.rs
index 627a31d4..353d8196 100644
--- a/crates/ogar-vocab/src/lib.rs
+++ b/crates/ogar-vocab/src/lib.rs
@@ -1117,6 +1117,17 @@ impl Class {
 ///   0x0DXX  HR                (employment / org / contracts)
 ///   0x0EXX  reserved: Genetics (CPIC pharmacogenomics, consumed by q2)
 ///   0x0FXX  Geo               (OpenStreetMap geodata reference ontology)
+///   0x90XX  reference         (ROOT of the domain reference tree)
+///   0x91XX  Disease · 0x92XX Phenomenology · 0x94XX Lab · 0x95XX Imaging
+///   0x96XX  BiologicalProcess · 0x97XX Substance · 0x98XX Procedure
+///   0x9AXX  Form
+///     ↑ the domain reference tree (`0x90..=0x9D`): HIGH byte = compartment,
+///       LOW byte = vocabulary, carried 1:1 from the retired 0x03XX block.
+///       0x93 anatomy and 0x99 genetics are deliberately NOT minted here —
+///       they are ALIASES onto the existing authorities 0x0A Anatomy and
+///       0x0E Genetics, which ogar-fma and ogar-cpic/q2 already consume.
+///       0x9E is NOT claimed: it is `has_phenotype` in ogar-ro's PREDICATE
+///       space, a different axis that overlaps these numbers.
 ///   0x10XX–0x16XX unassigned
 ///   0x17XX  reserved: Blocks  (visual block-programming vocabulary; consumed
 ///                              by blockly-rs / scratch-rs)
@@ -1644,6 +1655,105 @@ pub enum ConceptDomain {
     /// for minted names; GPL emulators (Frodo, zinc64, resid) stay
     /// behavioral/test-vector reference only — read, never transcribed.
     Mmio,
+    /// `0x90XX` — reference (domain reference tree; `data/config/domain_classids.tsv`).
+    /// the ROOT of the domain reference tree — the block that says "a biomedical reference domain" without yet saying which. Zero rows: it is the tree's handle, not a vocabulary.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Reference,
+    /// `0x91XX` — disease (domain reference tree; `data/config/domain_classids.tsv`).
+    /// MONDO / ICD-10-GM / Orphanet / OMIM / DECIPHER identity.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Disease,
+    /// `0x92XX` — phenomenology (domain reference tree; `data/config/domain_classids.tsv`).
+    /// HPO. Kept OUT of [`Disease`](Self::Disease) deliberately: a phenotype is what is observed, a disease is what is concluded.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Phenomenology,
+    /// `0x94XX` — lab (domain reference tree; `data/config/domain_classids.tsv`).
+    /// LOINC observables.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Lab,
+    /// `0x95XX` — imaging (domain reference tree; `data/config/domain_classids.tsv`).
+    /// RadLex, and FMA in its FINDING reading — the same structure addressed as an imaging finding rather than as anatomy.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Imaging,
+    /// `0x96XX` — biological_process (domain reference tree; `data/config/domain_classids.tsv`).
+    /// GO — the mechanism domain.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    BiologicalProcess,
+    /// `0x97XX` — substance (domain reference tree; `data/config/domain_classids.tsv`).
+    /// ATC / RxNorm / Gelbe Liste / ChEBI.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Substance,
+    /// `0x98XX` — procedure (domain reference tree; `data/config/domain_classids.tsv`).
+    /// OPS; SNOMED's procedure side needs its own lane (it does not fit 24 bit).
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Procedure,
+    /// `0x9AXX` — form (domain reference tree; `data/config/domain_classids.tsv`).
+    /// form MASTERS and schemata ONLY. A filled instance is patient data and stays behind the firewall — the master is public reference, the instance is not.
+    ///
+    /// Part of the `0x90..=0x9D` **domain reference tree**: the high byte is the
+    /// COMPARTMENT and the low byte is the vocabulary, carried 1:1 from the
+    /// retired `0x03XX` block. Carries ZERO shared vocabulary rows — the
+    /// concepts stay plug-and-play in their producers, same posture as
+    /// [`Ontology`](Self::Ontology). What the block buys is that a consumer
+    /// reads the compartment off the key (`classid >> 24`) instead of looking
+    /// it up.
+    Form,
     /// Any high-byte slot not yet assigned a domain (`0x05XX`–`0x06XX`,
     /// `0x10XX`–`0x16XX`, `0x18XX`–`0xBFXX`, `0xC2XX`–`0xC3XX`,
     /// `0xC5XX`, `0xC7XX`+).
@@ -1670,6 +1780,15 @@ pub fn canonical_concept_domain(id: u16) -> ConceptDomain {
         0x0E => ConceptDomain::Genetics,
         0x0F => ConceptDomain::Geo,
         0x17 => ConceptDomain::Blocks,
+        0x90 => ConceptDomain::Reference,
+        0x91 => ConceptDomain::Disease,
+        0x92 => ConceptDomain::Phenomenology,
+        0x94 => ConceptDomain::Lab,
+        0x95 => ConceptDomain::Imaging,
+        0x96 => ConceptDomain::BiologicalProcess,
+        0x97 => ConceptDomain::Substance,
+        0x98 => ConceptDomain::Procedure,
+        0x9A => ConceptDomain::Form,
         0xC0 => ConceptDomain::JavaRuntime,
         0xC1 => ConceptDomain::Analytics,
         0xC4 => ConceptDomain::BinaryLifting,
@@ -5522,6 +5641,64 @@ mod tests {
         assert_eq!(canonical_concept_id("user"), None);
     }
 
+    /// **The domain reference tree resolves, and its two deliberate holes
+    /// stay holes.** `0x90..=0x9A` minus `0x93`/`0x99` are the nine blocks
+    /// minted 2026-08-31 (`data/config/domain_classids.tsv`); the high byte
+    /// IS the compartment, which is what lets a consumer read it off
+    /// `classid >> 24` instead of looking it up.
+    ///
+    /// Two-sided on purpose: the nine must resolve, AND the three numbers
+    /// that look like they belong must NOT — `0x93`/`0x99` are aliases onto
+    /// the existing `Anatomy`/`Genetics` authorities (minting them here
+    /// would be a second source of truth for one domain), and `0x9E` is
+    /// `has_phenotype` in ogar-ro's predicate space.
+    #[test]
+    fn the_domain_reference_tree_resolves_and_its_holes_stay_holes() {
+        for (byte, want) in [
+            (0x90u16, ConceptDomain::Reference),
+            (0x91, ConceptDomain::Disease),
+            (0x92, ConceptDomain::Phenomenology),
+            (0x94, ConceptDomain::Lab),
+            (0x95, ConceptDomain::Imaging),
+            (0x96, ConceptDomain::BiologicalProcess),
+            (0x97, ConceptDomain::Substance),
+            (0x98, ConceptDomain::Procedure),
+            (0x9A, ConceptDomain::Form),
+        ] {
+            assert_eq!(
+                canonical_concept_domain((byte << 8) | 0x01),
+                want,
+                "block {byte:#04X} must resolve"
+            );
+        }
+        for hole in [0x93u16, 0x99, 0x9E] {
+            assert_eq!(
+                canonical_concept_domain((hole << 8) | 0x01),
+                ConceptDomain::Unassigned,
+                "{hole:#04X} must stay unminted here"
+            );
+        }
+    }
+
+    /// The tree carries **zero** shared vocabulary rows — the compartments
+    /// are reserved addresses, the concepts stay plug-and-play in their
+    /// producers. Same posture the Ontology block has, and the reason the
+    /// codebook mirror needs no rows for them.
+    #[test]
+    fn the_domain_reference_tree_mints_no_codebook_rows() {
+        let rows: Vec<&str> = CODEBOOK
+            .iter()
+            .filter(|(_, id)| (0x90..=0x9D).contains(&(id >> 8)))
+            .map(|(n, _)| *n)
+            .collect();
+        assert!(
+            rows.is_empty(),
+            "reference tree must stay row-free: {rows:?}"
+        );
+        // Anti-vacuity: the codebook is not empty in general.
+        assert!(CODEBOOK.len() > 50, "codebook must be populated");
+    }
+
     #[test]
     fn canonical_concept_name_round_trips() {
         // Every codebook id reverses to its name, and that name maps forward