Document Heimdall discovery admission

This commit is contained in:
Meta Vens 2026-08-22 04:08:47 +02:00
commit 0ed9562387
2 changed files with 22 additions and 0 deletions

View file

@ -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

View file

@ -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.