From 09761d41becf46ca408abb9643a3d9884822a2c1 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 12 Jul 2026 06:20:54 +0100 Subject: [PATCH] Map Epiphany app-server route consumers --- notes/epiphany-app-server-client-matrix.md | 48 +++++++++++++++++++++ notes/fresh-workspace-handoff.md | 7 ++- notes/native-coordinator-liberation-map.md | 10 +++++ state/ledgers.msgpack | Bin 413639 -> 414086 bytes state/map.yaml | 2 +- 5 files changed, 65 insertions(+), 2 deletions(-) create mode 100644 notes/epiphany-app-server-client-matrix.md diff --git a/notes/epiphany-app-server-client-matrix.md b/notes/epiphany-app-server-client-matrix.md new file mode 100644 index 00000000..5226081f --- /dev/null +++ b/notes/epiphany-app-server-client-matrix.md @@ -0,0 +1,48 @@ +# 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. + +## Unconsumed advertised routes + +| Route | Finding | Deletion owner | +|---|---|---| +| `roleLaunch` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `roleAccept` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `reorientLaunch` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `reorientAccept` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `index` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `distill` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `propose` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `promote` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `jobLaunch` | no executable caller | remove request registration, dispatch, handler, tests/docs | +| `retrieve` | no executable caller | remove request registration, dispatch, handler, tests/docs | + +Protocol DTOs may remain temporarily only when retained response projections or +bridge conversion tests still compile against them. A DTO is not authority and +must not keep an unconsumed request method registered. + +## 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. diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index a89054c7..84bc8f6e 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -1948,7 +1948,12 @@ nine named delegates and forbid local state/scheduler/prompt authority; read handlers forbid every actuator family; implicit event triggers remain absent. Dead bridge automation and checkpoint-pressure wrappers were deleted too. Next audit real client consumers of each `ThreadEpiphany*` route and delete any -compatibility API with no named living client. +compatibility API with no named living client. The client matrix now lives at +`notes/epiphany-app-server-client-matrix.md`: eight routes have named phase-6 +smoke or `epiphany-mvp-status --codex` consumers; ten advertised routes have no +executable caller beyond definitions/tests/docs and are marked for deletion. +Cut those ten request registrations, dispatch arms, handlers, tests, and README +claims next; do not let generated bindings count as clients. ## Immediate Re-entry Instruction diff --git a/notes/native-coordinator-liberation-map.md b/notes/native-coordinator-liberation-map.md index db4cbc61..6f8cb39b 100644 --- a/notes/native-coordinator-liberation-map.md +++ b/notes/native-coordinator-liberation-map.md @@ -374,3 +374,13 @@ prompt-steering, compaction, or scheduler symbol. Migration, read projection, notification projection, and explicit delegated actuation are the only allowed categories. The deleted event-loop reflex also left dead bridge automation and checkpoint-pressure wrappers; those zero-caller exports and imports are gone. + +Executable-client discovery is recorded in +`notes/epiphany-app-server-client-matrix.md`. Only eight routes have named +in-repo consumers, all explicit phase-6 smokes or +`epiphany-mvp-status --codex` fallbacks. Ten routes are advertised but +unconsumed: role/reorientation launch and accept, index, distill, propose, +promote, job launch, and retrieve. Definitions, generated bindings, README +claims, and serialization tests do not count as clients. Those ten request +registrations, dispatch arms, handlers, tests, and docs are the next deletion +line. diff --git a/state/ledgers.msgpack b/state/ledgers.msgpack index eb717b5cc905016c34f1ca7cf32ec3f9ab1a1a76..4569f6d8581af29509b5a732e072a199d6592bf7 100644 GIT binary patch delta 445 zcmY+Aze)o^5XQY2Q<%a=h$(~-(JGh3h<}JxigXGoQVD{4yOZ3SyWMklFC>+MpbsEN zN()~=u&}V#SMYJ1i$Sp%c7|`hZ+`6OQ}zD2`m*7bTg~?V(fP+xsmEWpy=%|=y2}a= zS;3>q-({*I)yi8|D7DUJw>zcsYOCKoXwRLq-g|NVGV7#5Iuw8taH^F6fdi?elSI`RqC&%R-aslL)zCJG!`X(=+_niT z!c&$i9@gf4hjUC^Z5Iq`BT>0uaWO9zfWmO{SXtY=xYEJjk|Wa?>(C=wY4fuJBg|1C hW+YC?2uc$|0~cT8vn25?nlT!mNBK?vXSE)S`Zp{eoj(8o delta 57 zcmZo$EO~ss