diff --git a/README.md b/README.md index 28225c1..3281d7f 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,17 @@ the Nightwing-resident terminal compositor in `E:\Projects\Gjallar` that consumes Odin's accepted `gamecult.eve.surface_state` snapshot over CultNet/RUDP and renders the live display. +## Typed access discovery + +Odin persists only document schemas it has registered. That is a deliberate +typed-store boundary, not a license to accept anonymous blobs and hope later +code understands them. The live Yggdrasil body at +`b4f9a2e95f0b41cebdeddc49223781d1d3c7b42a` registers Heimdall's provider, +command-boundary, Eve-plugin, and transport-profile documents. Heimdall owns +their contents; Odin owns catalog acceptance and exact retrieval. Sensitive +auth commands and claims travel directly between the consuming app and +Heimdall, never through Odin. + ## Gjallar Gjallar is the herald display daemon that runs on Nightwing. Odin sees the diff --git a/docs/architecture.md b/docs/architecture.md index 371dfd6..0b2a43d 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -76,6 +76,17 @@ Odin's executable body is split by ownership: - `src/odin/state.cjs`: one refresh's input records into Odin's provider catalog/proxy state. The entrypoint is not allowed to grow new probe, surface, provider, layout, or renderer policy. If a new owner is needed, name the owner and its invariant before adding code. +The accepted document registry is also the persistence admission boundary. +Unknown schemas may be observed for diagnostics but are not silently persisted +as untyped truth. Heimdall access discovery therefore registers +`gamecult.eve.provider_advertisement.v1`, +`heimdall.command_boundary.v1`, +`gamecult.eve.plugin_advertisement.v1`, and +`heimdall.transport_profile.v1`. Their globally unique record keys prevent one +schema from overwriting another in the shared catalog. Odin returns the +redacted route metadata; it does not proxy private auth operations or own any +claim, completion, token, or app secret. + Gjallar is the Nightwing-resident terminal compositor for what Odin can show. Its runtime lives in `E:\Projects\Gjallar` and consumes Odin's accepted provider-state snapshot over CultNet/RUDP.