Skip to content

FMA skeletal spine — bones as the clamped convergence anchor (Located-primary GUID)#116

Merged
AdaWorldAPI merged 5 commits into
mainfrom
claude/medcare-bridge-lance-graph-wmx76z
Jun 23, 2026
Merged

FMA skeletal spine — bones as the clamped convergence anchor (Located-primary GUID)#116
AdaWorldAPI merged 5 commits into
mainfrom
claude/medcare-bridge-lance-graph-wmx76z

Conversation

@AdaWorldAPI

Copy link
Copy Markdown
Owner

What this is

A new ogar-fma-skeleton crate: the hand-curated FMA skeleton as the
clamped convergence anchor for the splat-native ultrasound arc
(docs/SPLAT-NATIVE-CUSTOMER.md §6 litmus). Operator-directed across the
session; the address model converged through several corrections recorded
below.

The constraint (one, not two): bones must be hardcoded and stable
because they are the cross-modal registration frame that ViT, X-ray, and
ultrasound × Doppler all project onto. Bones are the only rigid bodies in the
human, so the skeleton is not data being fit — it is the boundary
condition
of the fit. Clamping the splat-fit to a hand-curated skeleton
makes the convergence well-posed and deterministic (the Class IIa SaMD
requirement).

The address — the [256:256] [container:member] GUID

Each bone resolves to a 16-byte Guid: a uniform stack of [256:256] tiers,
each the same scale-free relation [container : member] (Galaxy:planet,
country:city, bodypart:bone, cm²:mm², residue:atom). Bones are
Located-primary (they ARE the position anchor):

classid  = 0x0A03                  Anatomy : bone
HEEL/HIP = rest-pose 3-axis CRS    HEEL coronal x:y · HIP depth z   (ArcGIS / Cesium-addressable)
LEAF     = familyNode : identity   [bodypart : bone]
  • HEEL/HIP make the body a first-class GIS layer (Morton/quadkey), so
    off-the-shelf spatial ops work and ViT / ultrasound × Doppler project onto
    the same coordinate. Two HHTL modes are supported (HhtlMode):
    Located (Cesium, position-preserving — the bone case) and Cascade
    (ontology, the self-speaking path — the soft-tissue case).
  • LEAF family node IS the group: identity == 0 is the family node,
    identity ≥ 1 are its bones ("identity attached to family node").
  • Each byte is a directly-addressable 256-codebook and a 4×4 Morton tile
    carrying the perturbation pyramid's (exponent, location) (OGAR owns those;
    ndarray owns phase, magnitude).

Consumes D-MORTON (DISCOVERY-MAP §2.1); recorded as D-FMA-SKELETON.

Codebook

New ConceptDomain::Anatomy (0x0A) in ogar-vocab: anatomical_structure
/ skeleton / bone / joint (0x0A01..04), in lockstep across CODEBOOK +
class_ids consts + ALL + builders. Anatomy is public reference, not
PHI
— kept out of Health 0x09 so it is not dragged into medcare's
fail-closed Health RBAC set (preserves its Health == 7 invariant). The ~206
bones are cascade-path nodes under the bone concept, not codebook slots.

Relations

No 12+4 edge block — that is the pre-family-node taxonomy and was removed.
With family nodes, relations ARE the addressing: local = shared family
prefix (same_family), cross = a reference to another node's Guid.

Atlas coverage & honesty

~80 nodes: full vertebral column C1–coccyx, skull, sternum, 12 rib pairs,
major appendicular bones per side — structured to extend to the full ~206
without schema change. Rest poses are a proportional T-pose v0 (to be
refined against a real FMA-aligned mesh); FMA ids are cross-referenced only
where confidently known (the address identity is a stable atlas id, never a
fabricated FMA id). HIP is coronal-tile + depth-slice (not yet a single 3D
octree — its odd bits are reserved). The address structure is CODED;
the splat-fit convergence claim is CONJECTURE, gated on the splat-native
arc.

Tests / gates

cargo test -p ogar-fma-skeleton24 + 2 doctests green: Morton math,
classid tier, HEEL laterality, HIP depth, unique node keys + leaves,
family-node grouping with attached identity, parent-link partonomy, the
clamped-anchor invariant, unit-quaternion frames, classid stability.
ogar-vocab 94 tests green (drift gates updated for the anatomy mints).
The new crate is cargo clippy-clean; the 12 pre-existing ogar-vocab
clippy warnings are untouched (zero added).

Docs

docs/FMA-SKELETON-CONVERGENCE-ANCHOR.md (the unity, the GUID tier model,
located/cascade, the projection operators) + D-FMA-SKELETON in the
DISCOVERY-MAP.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 4 commits June 23, 2026 19:13
Operator directive (2026-06-23): "FMA is a must... bones not being
negotiable... hardcoded hand-optimized convergence optimization" +
"project ViT or X-ray and especially ultrasound × Doppler". The two
requirements are one constraint: bones must be hardcoded and stable
BECAUSE they are the cross-modal registration frame every modality
projects onto.

New crate `ogar-fma-skeleton`:
- morton.rs: the 2bit×2bit 4×4 Morton-tile pyramid. Uniform 16×8-bit
  (16-byte) family-node key — never a 12+4 carve (the operator
  correction: a heterogeneous carve breaks the uniform Morton stride
  and loses the perturbation-shader data). Each nibble = one 4×4 tile
  (X/Y interleaved); 32 levels; tier = level>>2. assign_morton_suffixes
  descends the sibling quadtree so prefix = spatial = partonomy.
- lib.rs: hand-curated atlas (~80 nodes: full vertebral column C1–coccyx,
  skull, sternum, 12 rib pairs, major appendicular bones per side).
  Each bone's 16-byte address is DERIVED from its rest-pose centroid, so
  parent.is_ancestor_of(child) holds AND laterality lives in the X-tile.
  Bones are clamped Dirichlet anchors by definition (no un-clamped bone).
  16 tests: tree integrity, prefix=partonomy=spatial containment, unique
  node keys, clamped-anchor invariant, unit-quaternion frames, laterality,
  address stability.

ogar-vocab: new ConceptDomain::Anatomy (0x0A) — anatomical_structure /
skeleton / bone / joint (0x0A01..04). Anatomy is public reference, not
PHI, so it gets its own domain (not Health 0x09, which would drag it into
medcare's fail-closed RBAC set). The ~206 bones are cascade-path nodes
under the `bone` concept, not codebook slots (FMA = the Wikidata-HHTL
pattern: the hierarchy lives in the path).

docs/FMA-SKELETON-CONVERGENCE-ANCHOR.md + DISCOVERY-MAP D-FMA-SKELETON.
Address structure CODED (16 tests); splat-fit convergence CONJECTURE,
gated on the splat-native arc (SPLAT-NATIVE-CUSTOMER.md §6 litmus).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
…ade, 12+4

Operator design download (2026-06-23, with the papillary-muscle worked
example + the located/cascade "heel" distinction):

- guid.rs: the brutal uniform GUID as a stack of [256:256] tiers, each the
  same scale-free relation [container:member] (Galaxy:planet, country:city,
  bodypart:bone, cm²:mm², residue:atom). Tier{container,member}, Guid with
  per-tier accessors, classid/heel/leaf, same_family ("identity attached to
  family node" = tiers..LEAF equal, identity varies).

- HhtlMode::{Located, Cascade} — the "heel" duality. Located (Cesium):
  HEEL is the literal position, HHTL = spatial_tier Morton, location-
  preserving — the BONE case (bones ARE the anchor). Cascade (ontology):
  HEEL is a classification rung (Anatomy…PapMuscle), no spatial address,
  HHTL = ontology_tier — the MUSCLE case (classified, then projected onto).
  Both share the LEAF familyNode:identity and the 16-byte key.

- EdgeBlock: the 12+4 edge block (12 in-family local relations + 4
  out-of-family inherited connector interfaces), one byte per slot — the
  papillary-muscle family-node template.

- LeafTile{family_node, identity} = the [bodypart:bone] leaf.

Additive — the working bone atlas (FamilyAddress) is untouched. 22 tests
green (16 + 6 new), clippy-clean. Doc §5b records the tier model + the
located/cascade duality + the splat-projects-onto-the-class framing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
Operator correction (2026-06-23): the 12-in-family + 4-out-of-family edge
block is the OLD taxonomy, before family nodes. Removed EdgeBlock entirely.

With the [container:member] family-node tiers, relations ARE the addressing:
- local relation  ⇔ shared family prefix (Guid::same_family)
- cross relation  ⇔ a reference to another node's Guid (unbounded)

No fixed edge carve; the node stays a pure key+value block. Test
`relations_are_family_prefix_not_an_edge_block` replaces the edge-block test;
doc §5b updated. Also recorded: located + cascade HHTL modes may both be used
on one key (operator's call). 22 tests green, clippy-clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
Each bone now resolves to a 16-byte Guid (the [256:256] container:member
tier model), Located-primary since bones ARE the position anchor:

  classid  = 0x0A03 (Anatomy:bone)
  HEEL/HIP = the rest-pose 3-axis CRS — HEEL coronal x:y, HIP depth z
             (located_heel_hip) — ArcGIS/Cesium-addressable, so the body is
             a GIS layer and ViT / ultrasound×Doppler project onto the same
             coordinate
  LEAF     = familyNode:identity = [bodypart:bone] — the parent group is the
             family (identity 0 IS the group's family node; identity >=1 are
             its bones)

same_family now keys on classid + leaf family_node (mode-agnostic): in
Located mode the spatial HHTL is the orthogonal location axis, so two
same-family bones sit at different positions. is_ancestor walks parent
links (partonomy), not an address prefix.

Tests rewritten for the Guid model (24 pass): classid tier, HEEL laterality
(left/right femur differ in HEEL, same family, different identity), HIP
depth (sternum anterior vs vertebra posterior), unique node keys + leaves,
family-node grouping with attached identity, parent-link ancestry, clamped
anchors, unit quaternions, classid stability. clippy-clean.

Morton primitives + FamilyAddress stay in morton.rs as the value-side
splat-refinement tool. Crate docs updated to the Guid model.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

The whole-workspace `cargo check + test` caught what per-crate testing
missed: ogar-class-view's OgarClassView registry has a drift gate
requiring every codebook concept to be registered, and the anatomy mints
(anatomical_structure / skeleton / bone / joint, 0x0A01..04) were absent.

Added them to all_canonical_classes() in codebook order (after health,
before auth) + the imports. Workspace test now fully green:
- every_codebook_id_appears_in_class_ids_all ... ok
- known_class_ids_iterates_in_stable_codebook_order ... ok
- registry_carries_every_codebook_concept ... ok

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
@AdaWorldAPI AdaWorldAPI merged commit 43f1930 into main Jun 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants