3.6 KiB
EpiphanyAgent Verse Service Contract
EpiphanyAgent is a service participant in the GameCult Verse. It already carries typed state through repo-contained CultCache/CultMesh bodies; the next coherence cut is to publish its meaningful operator/status surfaces as Eve GUI/TUI DSL so local runtimes can inspect Epiphany without reading private run artifacts.
Owner Map
- Owner: EpiphanyAgent owns Epiphany runtime state, organ state, role launches, local Verse context packets, operator status, operator snapshots, and public dream/export policy.
- Inputs: runtime-spine documents, heartbeat state, memory graph documents, role/reorient/job intents, local Verse context, Persona projections where applicable, and model/runtime receipts.
- Outputs: typed CultCache/CultMesh documents for internal status, operator snapshots, run intents/receipts, Verse policies, global room policies, launch-context packets, and future public dream documents.
- Derived state: JSON status files under
.epiphany-run, smoke artifacts, and local operator packets are witnesses or compatibility artifacts, not durable owners. - Forbidden writers: dashboards, shell wrappers, bridge adapters, app-server compatibility layers, and renderer surfaces must not directly mutate Epiphany truth. They emit command intent or read typed projections.
- Shared paths: CLI status, bridge status, local Verse query, operator snapshot, future Eve surface, and future compact TUI must read the same CultMesh-backed documents rather than each inventing a separate view.
- Deletion line: any bespoke presentation/status artifact that becomes the only source of a fact must be demoted behind CultCache/CultMesh or deleted.
Current State
EpiphanyAgent already has the lower substrate:
- vendored
cultcache-rs,cultnet-rs, andcultmesh-rs; cultcache.store.v1compatibility;- typed local Verse/status/operator documents in
epiphany-core; tools/epiphany_local_run.ps1 -Mode statusproducing operator-safe status artifacts and local Verse context;gamecult.persona_state.v0schema availability for public Persona projections.
The missing service-architecture surface is not "more JSON". It is an Epiphany-owned Eve surface provider.
Eve Surface Target
EpiphanyAgent should publish an Eve GUI/TUI DSL surface with these panels:
Operator Status: runtime id, bridge transport, authority owner, prompt authority separation, current run state, last status timestamp.Local Verse Context: visible Verse tier, advertised schemas, local peer context packet, and freshness.Runtime Spine: active jobs, role/reorient launches, accepted receipts, and blocked or denied intents.Memory Graph: profile availability, thin-state warnings, last refresh, and public/private boundary.Persona Projection: present only for public Persona/Persona projections usinggamecult.persona_state.v0; private organ state must not leak through this panel.
Each panel must expose authority and freshness. If a value comes from a JSON witness file instead of typed state, the surface should say so.
Migration Order
- Define the Epiphany Eve provider document/surface contract.
- Add an
epiphany-eve-surfaceread-only command that lowers the current CultMesh operator/status documents into Eve DSL. - Publish the surface through CultMesh/Odin discovery.
- Let Eve browser/native/TUI lower the same surface.
- Demote
.epiphany-runJSON status files to compatibility witnesses only.
The invariant: Epiphany runtime truth stays in typed CultCache/CultMesh documents. Eve makes it inspectable; Eve does not become the runtime brain.