Make EveCanvas the native Gjallar runtime

This commit is contained in:
Meta Vens 2026-08-25 03:56:53 +02:00
commit 29b0d7741d
10 changed files with 317 additions and 252 deletions

View file

@ -132,11 +132,11 @@ Fensalir Direct2D:
## Current Proof
The current native app consumes Mimir's dashboard WebSocket lowering for retained
dashboard state. That lowering is shaped like the future API: retained dashboard
state, provider switching, commands, and typed node metadata. It is a renderer
path over daemon-owned state, not provider discovery authority. Live provider
discovery belongs to Odin/CultMesh advertisements.
The current native iOS app consumes Gjallar's aggregate Eve surface through
Odin-owned Hermodr. Gjallar owns visible provider membership and weighted-bisect
layout intent. Hermodr only lowers the typed CultMesh record at the HTTP edge;
EveCanvas lowers the returned `surface.root` into UIKit and posts commands back
through the same bridge. Provider discovery remains Odin/CultMesh authority.
The Android proof under `android/` builds directly against the installed Android
SDK and runs on Periwinkle. It is deliberately small: display Eve's role, render
@ -156,12 +156,12 @@ pressure across the bench.
## Next Cut
1. Extract the shared surface schema from the iOS app and Mimir broker into a
versioned CultMesh contract.
2. Build the browser Eve runtime as the canonical renderer and comparison
target.
3. Add a replay harness that feeds recorded surface/sensor documents to browser
1. Admit readable provider-owned surface-state records into Odin so Gjallar can
compose live children instead of catalog-only advertisements.
2. Add a replay harness that feeds recorded surface/sensor documents to browser
and native clients.
3. Prove native command receipts through Hermodr and provider-owned command
routes.
4. Replace JSON/base64 sensor payloads with binary packets while preserving the
typed envelope.
5. Add Android client scaffolding against the same provider and sensor API.

View file

@ -35,7 +35,7 @@ proves the same contract at the CultMesh typed document sync layer.
| Windows / Flutter | Active owner runtime | `EveFlutter` consumes supplied `gamecult.eve.surface.v1` documents and emits phone/tablet/desktop golden PNGs through its owner capture runner | Needs native window capture and tighter text/style normalization |
| Linux / Flutter | Active shared graphical smoke target | Nightwing runs the Flutter parity goldens, including embedded surface slots, over SSH and returns phone/tablet/desktop PNGs | Needs native window capture and runner health checks |
| Android / Flutter | Active shared graphical smoke target | The same Flutter parity app is built as an APK, installed on Periwinkle, and captured at phone/tablet/desktop plus native physical-panel orientations | Needs live provider picker and command transport beyond fixture assets |
| iOS / UIKit | Active native screenshot target | SSH capture stages selected fixture JSON, EveCanvas renders it, and emits a PNG from `/var/mobile/Library/EveCanvas/latest-screenshot.png`; `embedded-surface` is part of the required fixture matrix | Not a plugin projection acceptance target until EveIOS owns adapters; still needs provider picker and command transport |
| iOS / UIKit | Active native Gjallar runtime and screenshot target | EveCanvas reads `gjallar.overview` through Hermodr, lowers its weighted-bisect aggregate with UIKit, and emits a device PNG from `/var/mobile/Library/EveCanvas/latest-screenshot.png`; fixture capture remains available as an offline parity oracle | Live aggregate is only as populated as Odin's readable provider surface-state records; command receipts and plugin projection acceptance remain |
| Android / Kotlin device edge | Active lightweight renderer | Native APK consumes CultMesh dashboard/sensor documents and preserves `surface.slot` / `embeddedDocuments` identity in the dashboard renderer | Not a plugin projection acceptance target; Android Flutter owns full graphical/plugin parity unless EveAndroid grows adapters |
| Rust / CultMesh | Document-sync contract runtime | CultLib replicates the `gamecult.eve.surface.v1` embedded slot contract through typed document sync | Not a pixel renderer |
| Fensalir Direct2D | External adapter spike, not active parity runtime | Fensalir has `src/Aquarium.EveSurface/EveSurfaceRuntime.cs`, reads an Eve broker, lowers into `AquariumUiDocument` / `DirectWriteOverlay`, and now has a runtime-pack `gamecult.eve.surface.v1` fixture in Eve | Needs runtime-owned command smoke, DirectWrite/Direct2D frame capture, and a clear reason to stay separate from Flutter for desktop UI |