This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/apps/epiphany-gui/README.md
2026-04-29 16:50:18 +01:00

1.5 KiB

Epiphany GUI

Local Tauri v2 + React operator console for the Epiphany MVP.

This app is not a source of truth. It reflects the existing app-server and artifact surfaces so the operator can inspect coordinator, CRRC, role, job, and artifact state without working through a terminal.

Current slice:

  • read-only operator console
  • calls tools/epiphany_mvp_status.py --json through a Tauri command
  • renders coordinator recommendation, pressure, CRRC/reorientation status, role lanes, role findings, jobs, and artifact bundles
  • writes explicit status-snapshot and coordinator-plan artifact bundles through bounded operator buttons

Run from this directory:

npm install
npm run dev
npm run tauri dev

Visual smoke:

npm run smoke:visual

The smoke runs the React shell in a browser with the bundled sample operator snapshot, clicks the bounded operator buttons, and writes:

  • .epiphany-gui/operator-console-smoke-desktop.png
  • .epiphany-gui/operator-console-smoke-mobile.png

The status bridge expects the local app-server binary used by the existing smoke tools. Build it from vendor/codex/codex-rs if needed:

$env:CARGO_TARGET_DIR='C:\Users\Meta\.cargo-target-codex'
cargo build -p codex-app-server

The first bounded buttons are intentionally narrow:

  • Status Snapshot writes a status JSON/transcript/stderr bundle under .epiphany-gui/status-snapshots.
  • Coordinator Plan runs tools/epiphany_mvp_coordinator.py --mode plan and writes an auditable bundle under .epiphany-dogfood.