Skip to content

docs(splat-native): §6 FMA-litmus customer narrative — splat-native ultrasound as the load-path customer of Phase 8 FMA hydration#34

Merged
AdaWorldAPI merged 1 commit into
mainfrom
claude/splat-native-customer
Jun 5, 2026
Merged

docs(splat-native): §6 FMA-litmus customer narrative — splat-native ultrasound as the load-path customer of Phase 8 FMA hydration#34
AdaWorldAPI merged 1 commit into
mainfrom
claude/splat-native-customer

Conversation

@AdaWorldAPI

Copy link
Copy Markdown
Owner

Summary

OGAR-side companion to the cross-workspace splat-native-ultrasound-v1 integration plan (canonical at lance-graph/.claude/plans/splat-native-ultrasound-v1.md). This PR ships one new doc that names splat-native ultrasound as the explicit customer of OGAR PR #30 §6 FMA-litmus + Phase 8 FMA hydration.

What this PR ships

docs/SPLAT-NATIVE-CUSTOMER.md (~260 lines).

No code. Narrative + cross-reference doc only.

TL;DR (from the doc)

OGAR PR #30 §6 names FMA bones-rendering as the architectural litmus:

"If HHTL can traverse 'what nerves innervate the left biceps brachii' in sub-millisecond without heap allocation, the architecture works."

Splat-native ultrasound is the customer of that litmus. A CPU-only Gaussian-splat ultrasound SaMD pipeline (the canonical plan in lance-graph) needs exactly this query at exactly this latency, on exactly this corpus (~75K FMA classes, ~2.1M relationships), for the splat-to-splat registration loop (live splat volume ↔ FMA atlas splat volume, via Σ-sandwich Mahalanobis ICP).

Three high-leverage takeaways for OGAR:

  1. Phase 8 from PR docs: RDF / OWL ↔ OGAR alignment — Morris triad + brutal-upgrade vision #30 is no longer abstract — it has a concrete customer waiting downstream. The TTL produced by Phase 8 is consumed by lance-graph D-SPLAT-8 (FMA atlas hydrator) which emits typed FmaEntity SoA + a pre-computed atlas splat volume (~150M Gaussians full body, ~5 GB compressed via the SH-aware palette extension in D-SPLAT-4).

  2. ADR-022 (The Firewall) is the SaMD evidence base. The splat-native arc lands as a SaMD Class IIa device. The audit-controls + access-controls evidence the regulator wants IS the ADR-022 firewall discipline + LanceMembrane::commit_event audit chain + KnowableFromStore registry that PRs feat: ogar-knowable-from — trait-mediated §10.3 producer seam (ADR-010 OGAR-side close) #25/docs: THE-FIREWALL — absolute inner/outer boundary, no serialization in hot path (ADR-022) #26/docs: HEALTHCARE-TRANSCODING — OGAR for HIPAA/healthcare (FHIR-grounded, label-free) #28/fix: #25 P2 canonical-identity keying + docstring back-refs + F-1 attestation #31 already shipped. No new OGAR architecture for SaMD certification — only documentation that names what's already true.

  3. The §6 FMA litmus is reframed from "demo target" to "load path." The sub-millisecond HHTL traversal claim IS the splat-native frame-rate budget's gating threshold (<150ms/frame total budget; sub-ms NiblePath traversal + <10ms atlas-region paging + <100ms ICP + <33ms render).

Composed litmus (the SaMD acceptance gate)

Given a live ultrasound splat volume (~10⁶–10⁷ Gaussians/frame, ~30 fps, CPU-only on a HoloLens-class device) and the FMA atlas splat volume (~150M Gaussians, ~5 GB on disk, region-paged), the inner loop must:
(1) Resolve atlas_region_id via NiblePath traversal — sub-millisecond (the original §6 claim).
(2) Page the matching atlas-region Gaussians — <10ms.
(3) Run Σ-sandwich Mahalanobis ICP — <100ms.
(4) Emit pose + per-Gaussian class_id back.
(5) Render the patient-aligned overlay — <33ms.
Total inner-loop budget: <150ms/frame, CPU-only, no GPU vendor lock.

What this arc adds to OGAR's roadmap

Confirms (no new work)

Surfaces (small, additive; sized within existing Phase 8 budget)

  • A new vocab/fma-alignment.ttl (FMA ↔ OGAR Class correspondence)
  • vocab/ogit-fma.ttl declaring FMA-specific OGIT predicates (isA, partOf, innervates, supplies)

Reframes (zero new work; framing only)

  • §6 weight shifts from demo to load-path acceptance gate

Three FINDINGs (verified against existing OGAR + lance-graph state)

Three CONJECTUREs (need OGAR-session confirmation)

  • C-SPLAT-O-1: FMA TTL NiblePath identity prefix structure is sub-millisecond-traversable at ~75K classes per §6. Verify via prototype on real FMA (not synthetic).
  • C-SPLAT-O-2: vocab/ogit-fma.ttl minimum predicate set sufficient for registration (4 named; defer to D-SPLAT-9 review).
  • C-SPLAT-O-3: bardioc PR docs: SurrealQL AST as universal adapter — feasibility, beauty, brutal honesty #19 substrate-b-shadow §14-oracle pattern is the right shape for splat-native clinical-study validation (SaMD D-SPLAT-14).

Action items for OGAR session (when Phase 8 work opens)

Test plan

  • Docs only — no source code, no cargo invoked.
  • Cross-session companion to lance-graph canonical plan.
  • PII abort-guard scan clean (FHIR resource names used as public-spec terms only).
  • OGAR Phase 8 session reads this doc as the customer-side bootload before Phase 8 implementation begins.

Cross-PR coordination

This is one of four coordinated PRs for the splat-native-ultrasound-v1 cross-workspace plan. All four reference each other; lance-graph is canonical.

Repo Branch What
lance-graph claude/splat-native-ultrasound-v1 canonical plan + board hygiene (14 D-SPLAT-* deliverables)
ndarray claude/splat-native-ultrasound-v1 D-SPLAT-2 SIMD substrate plan (5 batch primitives, three-backend mandatory)
MedCare-rs claude/splat-native-ultrasound-v1 D-SPLAT-10/11 HIPAA wire handover
OGAR claude/splat-native-customer §6 FMA-litmus customer narrative

Triggered by user-supplied architecture diagrams (English 6-stage technical + German business-facing). No source code in any of the four PRs — design-spec / handover only.


Authored by session claude/lance-graph-ontology-review-Pyry3.

Cross-session companion to the lance-graph splat-native-ultrasound-v1
canonical plan. Names splat-native ultrasound as the explicit downstream
customer of OGAR PR #30 §6 FMA bones-rendering litmus + Phase 8 FMA
hydration.

The §6 litmus transitions from "demo target" to "load path" — splat-native
is the contemporary customer of the FMA atlas substrate at the
sub-millisecond HHTL traversal claim. The SaMD Class IIa certification
track uses ADR-022 (The Firewall) + KnowableFromStore (PR #25/#31) +
commit_event audit (callcenter PR #467) as the audit-controls evidence
base — no new OGAR architecture for SaMD; only documentation that names
what's already true.

No code. Spec/narrative only.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ae92159d8e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +245 to +246
- **IVD-MDR Rule 11** — EU SaMD risk classification (Class IIa for
diagnostic-software with non-critical decision support).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct the regulatory basis for Rule 11

For the EU SaMD path described here, Rule 11/Class IIa is an MDR Annex VIII classification, not an “IVD-MDR”/IVDR one; IVDR is for in-vitro diagnostics and uses A–D risk classes. Because this section is the regulatory cross-reference future D-SPLAT-14 work will follow, leaving the wrong regulation name can send the certification/evidence plan down the wrong rule set for the stated ultrasound SaMD device.

Useful? React with 👍 / 👎.

@AdaWorldAPI AdaWorldAPI merged commit 0442071 into main Jun 5, 2026
1 check passed
AdaWorldAPI added a commit that referenced this pull request Jun 5, 2026
…ex VIII Rule 11)

Follow-up to PR #34 (merged). Addresses one codex P2 finding.

## Fix — Regulatory basis for Rule 11 / Class IIa (codex P2)

The §4 standards / vocabularies index cited "IVD-MDR Rule 11" as the
EU SaMD risk classification for splat-native ultrasound. This is the
wrong regulation. IVDR (the In-Vitro Diagnostic Regulation 2017/746)
governs IN-VITRO DIAGNOSTICS (e.g., blood tests, immunoassays) and
uses A-D risk classes. Ultrasound SaMD is regulated under the MDR
(Medical Device Regulation 2017/745); the applicable classification
rule is **MDR Annex VIII Rule 11**.

Because this section is the regulatory cross-reference future
D-SPLAT-14 (SaMD documentation track) work will follow, leaving the
wrong regulation name would send the certification/evidence plan
down the wrong rule set for the stated ultrasound device.

Fix: corrects the IVD-MDR entry to MDR Annex VIII Rule 11 and adds
a half-sentence call-out explaining that IVDR is a separate
framework that does NOT govern this device. The Class IIa
classification claim is unchanged (just attached to the correct
regulation now).

Companion fix in the lance-graph canonical plan (PR follow-up to
#471) which had the same wrong citation in the D-SPLAT-14 row of
both the plan body and the STATUS_BOARD.

## What's NOT in this PR

- Source code: still none. Narrative-only doc.
- The other regulatory standards (IEC 62366 usability, IEC 80001
  risk, ISO 14971 risk-management) are unchanged.
- The Class IIa classification claim itself is unchanged (it was
  correct; only the regulation citation was wrong).

## Test plan

- [x] Codex P2 (regulatory basis) — IVD-MDR → MDR Annex VIII Rule 11.
- [x] Cross-grep: no remaining IVD-?MDR references in this file.
- [ ] Codex re-review on this PR.
AdaWorldAPI added a commit that referenced this pull request Jun 5, 2026
…fixes

docs(splat-native): address review feedback on #34 (IVD-MDR → MDR Annex VIII Rule 11)
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.

1 participant