# Sophia RAG Knowledge Pages

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.