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/notes/epiphany-app-server-client-matrix.md
2026-07-12 07:01:13 +01:00

2.4 KiB

Epiphany App-Server Client Matrix

This map classifies the remaining experimental thread/epiphany/* JSON-RPC surface by executable consumers in this repository. Definitions, generated bindings, README prose, protocol serialization tests, archived notes, and the handler itself do not count as clients.

Living explicit compatibility clients

Route Executable consumer Compatibility purpose
view phase-6 scene/reorient/pressure/planning smokes; epiphany-mvp-status --codex old aggregate read projection
roleResult epiphany-mvp-status --codex old worker-result read projection
freshness phase-6 freshness smoke old freshness projection
context phase-6 context smoke old context projection
graphQuery phase-6 graph-query smoke old graph projection
reorientResult epiphany-mvp-status --codex old reorientation-result projection
jobInterrupt epiphany-mvp-status --codex explicit delegated interruption fallback
update phase-6 scene/context/freshness/graph/reorient/planning smokes explicit delegated state-update fallback

These are retained only while the named compatibility binaries remain. They do not justify route-local policy, implicit triggers, Codex state ownership, or new clients.

Removed unconsumed routes

Route Finding Result
roleLaunch no executable caller request surface deleted
roleAccept no executable caller request surface deleted
reorientLaunch no executable caller request surface deleted
reorientAccept no executable caller request surface deleted
index no executable caller request surface deleted
distill no executable caller request surface deleted
propose no executable caller request surface deleted
promote no executable caller request surface deleted
jobLaunch no executable caller request surface deleted
retrieve no executable caller request surface deleted

The deleted methods' protocol DTOs, duplicate worker-launch document hierarchy, retrieve projection module, bridge conversions, and generated schema exports are gone. A DTO is not authority and does not survive merely because codegen can describe it.

Evidence rule

Before retaining or restoring a route, name the executable client path and show its request invocation. Self-reference, generated output, and serialization tests are not evidence of use.