Fighting Game · Guides & deep dives

Sophia RAG Knowledge Pages

companion codex, and public API replay context.

2sections1 minread
Markdown source
On this page

The V2 frame-data wiki, glossary, and roadmap are shell-native web pages at:

  • /v2/wiki
  • /v2/glossary
  • /v2/roadmap

The pages use @sophia/client as the canonical RAG contract surface. The web model at apps/oshun/web/src/v2/sophia-rag.ts builds typed RAGResponse, Citation, and SearchResult objects from the V2 frame-data, public API, companion, and architecture corpus so the UI can render grounded answers without depending on live gameplay authority or a network-only Sophia service.

Guarantees#

  • Every page renders a Sophia RAG answer with citations and source confidence.
  • The frame-data wiki links player-facing move rows to cited frame-data schema, companion codex, and public API replay context.
  • The glossary defines combat terms with exact frame semantics and rollback architecture citations.
  • The roadmap cites the completed shell tile, mobile companion, public API, and pending frame-data publisher path.
  • Browser coverage exists at apps/oshun/web/e2e/v2-knowledge-surfaces.spec.ts, including mobile overflow validation.

Verification#

The repo check is python3 V2/ue/Tools/check-v2-sophia-rag-pages.py. It is wired into .github/workflows/v2-build.yml and validates the routes, component, model, tests, dependency wiring, citations, docs, and TODO completion state.