From 89006baa137f8d16923ab3d5a7571d0fe543358e Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Tue, 12 May 2026 22:07:22 +0100 Subject: [PATCH] Close Epiphany rebuild migration audit --- ...piphany-ideal-architecture-rebuild-plan.md | 24 ++++++++++++++++++ notes/fresh-workspace-handoff.md | 18 ++++++------- state/ledgers.msgpack | Bin 67157 -> 67714 bytes state/map.yaml | 4 +-- 4 files changed, 35 insertions(+), 11 deletions(-) diff --git a/notes/epiphany-ideal-architecture-rebuild-plan.md b/notes/epiphany-ideal-architecture-rebuild-plan.md index ed89e5f2..afc1cf6f 100644 --- a/notes/epiphany-ideal-architecture-rebuild-plan.md +++ b/notes/epiphany-ideal-architecture-rebuild-plan.md @@ -547,3 +547,27 @@ The rebuild is working when: - adding a new view lens requires a core contract, not copying a mapper cluster That is the smallest machine that still deserves the name Epiphany. + +## Completion Audit + +As of 2026-05-12, the documented rebuild migration is complete enough to +defend: + +- app-server Epiphany code is routing/adaptation for the MVP surfaces, runtime + loading, and protocol response assembly. +- scene, jobs, roles, planning, pressure, reorient, CRRC, coordinator, + freshness, context, graph traversal, role/reorient result interpretation, and + role/reorient acceptance policy have core contracts in `epiphany-core`. +- runtime-spine owns job/result lifecycle identity through `runtime_links`; + durable `jobBindings` are only authority slots. +- live duplicate acceptance is keyed by typed acceptance receipts. +- normal public findings project typed fields and artifact refs rather than + raw worker payloads. +- Aquarium-facing read models use the canonical `thread/epiphany/view` lens + plus bounded read-only freshness/context/graph/result surfaces. +- heartbeat state is typed and cognition experiments remain quarantined. +- adding a new view lens now means adding or reusing a core surface contract, + not copying another app-server mapper pile. + +Remaining work after this point is outward product/bridge/dogfood work or a new +documented migration, not this teardown plan wearing a fake mustache. diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index 314fb9e5..5d648a0f 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -32,7 +32,7 @@ remembers doctrine; the branch remembers the blade. ## Current Orientation - Do not copy exact branch or HEAD from this note. Run `git status --short --branch` and `git log --oneline -5`. -- Top priority is still foundation cleanup until the documented rebuild audit is closed. Read `notes/epiphany-architectural-teardown.md` before touching Epiphany control-plane code. The May 2026 suspicion pass found that the app-server Epiphany control plane had become architectural Jenga: too much policy, projection, lifecycle glue, prompt packet assembly, coordinator sequencing, and test authority lives in `vendor/codex/codex-rs/app-server/src/codex_message_processor.rs`. The rebuild has moved scene projection, freshness derivation, pressure policy, targeted context shards, bounded graph traversal, job/progress view derivation, planning view derivation, reorientation resume/regather verdict policy, pure CRRC recommendation policy, fixed-lane coordinator decision policy, role-board projection policy, role/reorient result interpretation, role self-persistence review policy, and role/reorient acceptance bundle policy into `epiphany-core`; typed acceptance receipts replaced summary-string identity for live accept paths, runtime links are dual-written on launch, and result read-back now prefers runtime links. +- The May 2026 foundation migration in `notes/epiphany-ideal-architecture-rebuild-plan.md` is complete enough to defend. Read `notes/epiphany-architectural-teardown.md` before touching Epiphany control-plane code, but do not treat it as an open-ended excuse to keep shaving the altar. The rebuild moved scene projection, freshness derivation, pressure policy, targeted context shards, bounded graph traversal, job/progress view derivation, planning view derivation, reorientation resume/regather verdict policy, pure CRRC recommendation policy, fixed-lane coordinator decision policy, role-board projection policy, role/reorient result interpretation, role self-persistence review policy, and role/reorient acceptance bundle policy into `epiphany-core`; typed acceptance receipts replaced summary-string identity for live accept paths, runtime links are dual-written on launch, and result read-back now prefers runtime links. - Read `notes/epiphany-ideal-architecture-rebuild-plan.md` immediately after the teardown. It defines the smallest coherent replacement architecture: durable `EpiphanyState`, runtime-spine-owned `RuntimeState`, separate role memory/heartbeat state, `epiphany-core` as policy owner, app-server as adapter, Aquarium as reflector, typed acceptance receipts, and derived view lenses instead of a protocol verb zoo. - Do not continue Aquarium UI, bridge, Face, or dogfood expansion until the teardown has a source-grounded cleanup slice plan. Epiphany is the foundation; patches on patches are not a purification rite, they are how the altar becomes load-bearing garbage. - Phase 1 through Phase 5 are complete enough. @@ -362,10 +362,9 @@ that change what the next agent should believe. Do not continue implementation automatically from a rehydrate-only request. -The next real move is still the final foundation cleanup audit. Start from -`notes/epiphany-architectural-teardown.md` and -`notes/epiphany-ideal-architecture-rebuild-plan.md`, not from the older outward -Phase 6 bridge/UI trail. Landed rebuild cuts: `epiphany-core/src/surfaces/` +The next real move is no longer the rebuild migration. That rite is closed +unless a concrete regression reopens it. Landed rebuild cuts: +`epiphany-core/src/surfaces/` exists, pressure view derivation/tests, pure CRRC recommendation policy/tests, fixed-lane coordinator decision policy/tests, role-board projection policy/tests, role-result interpretation/self-persistence review policy/tests, and role/reorient @@ -375,10 +374,11 @@ runtime links, result read-back prefers those runtime links, normal public `raw_result` is sealed, MVP consumers use `thread/epiphany/view`, heartbeat cognition is quarantined, and the old scene/jobs/roles/planning/pressure/reorient/ CRRC/coordinator read wrappers are deleted, and durable `jobBindings` no longer -carry launcher/backend/progress lifecycle fields. The next pass is to audit the -plan's remaining success criteria and, if no remaining policy cluster is found, -mark the rebuild migration complete enough to defend. No Agile confetti. No new -balcony on the swaying tower. +carry launcher/backend/progress lifecycle fields. The next pass is outward: +build-verify/package the Rider plugin scaffold when Gradle/wrapper support +exists, install Unity `6000.1.10f1`, then run the next bridge-equipped Aetheria +dogfood pass through Epiphany's GUI/coordinator/fixed lanes with operator-safe +artifacts. No Agile confetti. No new balcony on the swaying tower. The Phase 6 freshness slice is landed. It exposes read-only `thread/epiphany/freshness` from live retrieval summaries plus graph diff --git a/state/ledgers.msgpack b/state/ledgers.msgpack index 3237cad613a89b063fdb4c415257b8cf67c3ceb5..9706b9884bdc52cfb49cc5dc9e766b127467a21f 100644 GIT binary patch delta 524 zcmX|8J#Q324AsIF{D6qs5<-0FE_Zt(AO(pcGzdh8C}<+zj_=O7+410+$!e=aNlO7b z30f)|sz{O2EO%P zLA7=B$!@)VHhTE-=W{QK9ONZ|lcuy3vZb%Fhv{Vc7&4(c>B3lPR@gged7+qD0$_2R zx8W@*&zao%_pjSW5XE!TLn@pJ?myZwf|Sz(z~BI593|32QfTdM0UgF{@w&bK*Zvg5 zMx|^h^b!b^&_SmgRI;o^4zRGw5caTHQE;y~xG^`P1kqzdOJgwRL#7TI30bkp3DC+{ zFjo|3p5Q=cdj{pOxT<2wOHt0I!HXdz_2=dW*ZL4{B}VOvt@d)QIT6zU|}lzegKQc1HE|&9vT~*qQ5he*jzFy?y`y delta 49 zcmZpg$a1xZWr8vjoAgH2X^f1kn)fhn-^0k*%p%sX#mK