594 lines
65 KiB
Markdown
594 lines
65 KiB
Markdown
# Fresh Workspace Handoff
|
|
|
|
This is the re-entry rite for `E:\Projects\EpiphanyAgent`: the waking chant for
|
|
the local machine-spirit before it touches the forge.
|
|
|
|
It is intentionally short. Historical proof belongs in git, commit messages,
|
|
smoke artifacts, and the distilled `state/ledgers.msgpack` evidence reliquary;
|
|
exact control flow belongs in `notes/epiphany-current-algorithmic-map.md`;
|
|
forward campaign planning belongs in `notes/epiphany-fork-implementation-plan.md`.
|
|
Do not let this file become a second brain. That way lies holy-looking sludge.
|
|
|
|
## Rehydrate
|
|
|
|
From the repo root:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-state -- status
|
|
Get-Content '.\state\map.yaml'
|
|
Get-Content '.\notes\fresh-workspace-handoff.md'
|
|
Get-Content '.\notes\epiphany-current-algorithmic-map.md'
|
|
Get-Content '.\notes\codex-starvation-and-cultnet-liberation-plan.md'
|
|
Get-Content '.\notes\epiphany-architectural-teardown.md'
|
|
Get-Content '.\notes\epiphany-ideal-architecture-rebuild-plan.md'
|
|
Get-Content '.\notes\epiphany-fork-implementation-plan.md'
|
|
git status --short --branch
|
|
git log --oneline -5
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-state -- status
|
|
```
|
|
|
|
Do not trust this file for the exact live HEAD. Always check git. The rite
|
|
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`.
|
|
- The active foundation directive is now `notes/codex-starvation-and-cultnet-liberation-plan.md`. The previous Codex app-server control-plane rebuild made Epiphany less rotten inside Codex, but that is not the destination. Epiphany must become a native CultCache/CultNet runtime. Codex is a compatibility reliquary for OpenAI subscription auth and model transport, not the host brain.
|
|
- Edge JSON is allowed for schema description, hostile ingress before immediate typed parsing, sealed forensic artifacts, or named quarantine experiments. When both subsystems are ours, runtime data must remain typed CultCache documents and move over CultNet typed contracts. Generic `serde_json::Value` in worker launch/result/selfPatch/runtime flow is contamination until classified and replaced.
|
|
- 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.
|
|
- Phase 6 has canonical read-only `thread/epiphany/view` lenses for scene, jobs, roles, planning, pressure, reorient, CRRC, and coordinator; separate read-only `thread/epiphany/freshness`, `thread/epiphany/context`, and `thread/epiphany/graphQuery` query surfaces; `thread/epiphany/reorientResult`; and `thread/epiphany/roleResult`. Durable `jobBindings` are now legacy launcher compatibility slots only; they keep binding id/kind/scope/owner/authority/linkage/blocking reason while durable `runtimeLinks` hold runtime-spine job/result association. The old standalone scene/jobs/roles/planning/pressure/reorient/CRRC/coordinator read verbs have been deleted; read those projections through view lenses. New `thread/epiphany/jobLaunch`, `thread/epiphany/jobInterrupt`, `thread/epiphany/roleLaunch`, and `thread/epiphany/reorientLaunch` writes open typed runtime-spine job receipts under `state/runtime-spine.msgpack` and do not require the Codex SQLite state runtime. Freshness carries watcher-backed invalidation inputs, graphQuery traverses authoritative typed graph neighborhoods and path/symbol matches without mutation, planning projects typed captures/backlog/roadmap/objective drafts without adopting work, roles project implementation/imagination/modeling/verification/reorientation ownership from existing signals without becoming a scheduler, `roleResult` and `reorientResult` read heartbeat-backed typed runtime-spine job results through runtime links when present, and `roleAccept` / `reorientAccept` accept completed heartbeat findings by writing typed acceptance receipts while remaining explicit review gates.
|
|
- Native `epiphany-mvp-status` is the first dogfood operator view. It starts or reads a thread through app-server and prints scene, planning, pressure, reorient, jobs, roles, Imagination/modeling/verification role result read-backs, reorient result, heartbeat, Face bubbles, and CRRC recommendation as text or machine output. The old Python status module has been cut; native Rust/CultCache/CultNet surfaces are the smoked product path.
|
|
- Native `epiphany-mvp-coordinator` is the first auditable fixed-lane coordinator runner. It starts or reads a thread through app-server, opens a native runtime-spine session, follows the harness-native coordinator action, can auto-launch modeling, verification, or reorient-worker jobs, records native runtime job/result receipts for terminal launched work, keeps semantic findings review-gated by default, and writes summary, steps, rendered snapshots, transcript, stderr, runtime-spine status, and final next-action artifacts under `.epiphany-dogfood/coordinator` or a caller-provided artifact directory. It refuses direct backend-completion mutation; full completion smoke needs live workers while execution is being cauterized into CultNet.
|
|
- Native `epiphany-runtime-spine` is the first Codex-independent runtime vertebra. It owns typed CultCache documents for runtime identity, sessions, jobs, job results, and events; opens/completes native jobs; snapshots jobs/results by runtime job id; projects job-result counts; and can emit a framed CultNet hello message advertising the native document and mutation contract surface. Codex app-server launch/read-back/acceptance is now a typed heartbeat/runtime-spine bridge with no Epiphany job-result dependency on the Codex SQLite runtime.
|
|
- CultNet APIs are advertised as compatible schemas plus mutation contracts. Hello frames now expose readable document types, allowed operations, mutation authority, typed intent document types, and typed receipt document types; Aquarium should use those contracts to submit state changes and watch receipts rather than growing a little bespoke verb zoo.
|
|
- The native runtime-spine hello now publishes the interactive surface catalog, not just the deep runtime bones. In addition to runtime/session/job/memory/heartbeat/ledger documents, Aquarium-discoverable contracts now advertise scene, pressure, reorient, CRRC, jobs, roles, role-result, reorient-result, planning, coordinator, Face, Void memory, repo initialization/birth runner, Rider bridge, and Unity bridge surfaces, with explicit read-only versus coordinator-owned intent/receipt posture. The point is to let Aquarium discover operator affordances from CultNet instead of hard-coding a secret menu of verbs.
|
|
- Epiphany now publishes those CultNet receipts locally under `schemas/cultnet/`, and `epiphany-runtime-spine schema-catalog --include-schema-json true` emits a merged builtin-plus-local schema catalog Aquarium can consume directly. The local catalog covers runtime-spine documents, durable agent/heartbeat/ledger state, operator-safe `epiphany.surface.*` projections, control intents, and receipt/artifact payloads. The vendored `cultnet-rs` wire contract was aligned with the C# canon at the same time: raw document replication now keys on `schemaId` and `recordKey`, snapshot filters use `schemaIds` / `recordKeys`, and hello supports typed mutation-contract advertisement instead of the old half-remembered payload-schema-version folklore.
|
|
- Epiphany now owns the canonical schema paperwork locally under `schemas/`. The key receipts are `schemas/ghostlight.agent-state.schema.json`, `schemas/canonical-agent-state-schema.md`, `schemas/agent-state-variable-glossary.md`, `schemas/repo-personality-birth-projection.md`, and `schemas/heartbeat-state-schema.md`. If a standing trait name like `routing_discipline` changes, or if dossier/heartbeat/birth-projection semantics move, update those docs in the same pass instead of relying on old Ghostlight notes or live store archaeology.
|
|
- The schema doctrine now makes the dossier split explicit: most resident Epiphany organs are `lane_core` dossiers with a lean role lattice and growth via rumination/distillation, while Face is an `embodied_actor` dossier that should trend toward dense Ghostlight-family personality, relationship pressure, and fallible character-loop response. `epiphany-agent-memory-store status` and `epiphany-character-loop` now surface that classification on the wire.
|
|
- Face packets now carry deterministic Ghostlight-style `projectionSeed`, `appraisalSeed`, and `reactionSeed` surfaces rebuilt from local dossier traits, relationship memories, perceived overlays, and visible stimulus so the public mouth can use actual projection/appraisal machinery instead of decorative prompt text. Also record this now before some future fool hard-codes singularity: multiple Face actors are part of the plan, even though the current MVP still routes through one `face` role.
|
|
- Repo personality initialization now has a terrain-reduced plan and native birth surface. `epiphany-repo-personality scout/project/agent-packet/status` scouts local git repos, scores body taxonomy/history temperament/memory doctrine, writes typed CultCache terrain/profile/role-projection MessagePack stores, emits JSON/Markdown inspection exports, and renders a birth-only Repo Personality Distiller specialist prompt packet. `epiphany-repo-personality startup` now checks for accepted personality/memory initialization records, launches packet generation only when absent, and `accept-init` can route reviewed role `selfPatch` candidates into initial role memory, stamp the newborn Ghostlight trait lattice from deterministic role projections, and seed heartbeat physiology from the same typed role personality projections. The birth specialists are startup-only initialization actuators, not heartbeat lanes; heartbeat receives only the accepted physiology seed. `epiphany-repo-birth-runner` now owns the startup-only execution path: plan mode writes Codex execution prompts/schemas/accept commands, and run mode invokes `codex exec` with the packet schema and captures reviewable `result.json`. The remaining seam is Aquarium review/action surfacing. After accepted birth, personality drift belongs to heartbeat, mood, rumination, sleep consolidation, lived evidence, and reviewed `selfPatch`, not repeated startup distillation.
|
|
- Repo trajectory initialization is now a separate birth-only organ. `epiphany-repo-personality` derives a typed `repo_trajectory_report` from early-history, recent-history, doctrine/content excerpts, and deterministic theme scoring, and `trajectory-packet` renders a startup-only Repo Trajectory Distiller prompt/packet so Self can review historical direction, self-image, implicit goals, and anti-goals before the newborn wakes.
|
|
- Repo memory initialization is now split from personality initialization. `epiphany-repo-personality memory-packet` renders a birth-only Repo Memory Distiller packet from the same typed terrain/profile/projection store plus bounded source excerpts. It gives each organ its own mission filter: Self for routing/authority, Face for public surface, Imagination for plans/backlog, Eyes for prior art, Body for architecture, Hands for implementation habits, Soul for evidence, and Life for continuity. The output is still a Self-reviewed petition, not direct memory mutation.
|
|
- The first birth startup valve is now native. `epiphany-repo-personality startup` checks a typed init store for accepted `repo-trajectory`, `repo-personality`, and `repo-memory` records, generates missing packets under a startup artifact dir, and returns `reviewInitializationPackets`. Generated birth packets now advertise `birthOnly`, `executionOwner: repo-initialization-startup-runner`, and no heartbeat participant. `epiphany-repo-birth-runner` consumes those packets as startup-only Codex exec jobs and writes prompts, output schemas, stdout/stderr logs, result files, and exact `accept-init` commands. `accept-init` can process a distiller result, review/apply role `selfPatch` candidates through `state/agents.msgpack`, apply `repo-personality` heartbeat seeds through `state/agent-heartbeats.msgpack`, and seal the reviewed packet as `epiphany.repo_initialization_record.v0`; after all required records exist, startup returns `continueStartup` and does not regenerate birth packets. The remaining UI wound is Aquarium review/action surfacing.
|
|
- Native CRRC automation is now landed only at turn-complete safe boundaries. It may submit `Op::Compact` for coordinator-approved `compactRehydrateReorient` or for a successful pre-compaction checkpoint intervention's pending compact handoff, and it may launch the fixed `reorient-worker` for coordinator-approved `launchReorientWorker`. It does not auto-launch Imagination/modeling/verification, accept findings, promote evidence, edit implementation code, or keep going after reviewable semantic output.
|
|
- Pre-compaction checkpoint intervention is now landed. On token-count events for loaded Epiphany threads, when current context usage reaches 80% of the active auto-compact/context limit, the harness steers the active turn once with a CRRC checkpoint directive so the agent banks working context before compaction/reorientation. Pressure ignores cumulative token spend; cumulative-only telemetry reports unknown instead of yelling. A successful steer now latches a turn-scoped compact handoff that is consumed at clean turn completion, preventing the brake from decaying into another implementation turn. This is still bounded steering plus compaction handoff, not automatic semantic acceptance, a broad scheduler, or implementation continuation.
|
|
- The old Python dogfood/live-specialist runners were cut because they encoded the obsolete completion path. The replacement must be native Rust/CultCache/CultNet and complete heartbeat-owned runtime-spine job results with auditable artifacts.
|
|
- The Aquarium operator UI now lives in sibling repo `E:\Projects\EpiphanyAquarium`, not under `apps/epiphany-gui`. It is a Tauri v2 + React/WebGL interface organism over the existing status bridge, dogfood artifacts, and GUI action artifacts, not a new throne of truth. It has its own `AGENTS.md`, persistent `state/map.yaml`, `state/memory.json`, scratch/evidence files, and interface doctrine. EpiphanyAgent remains the authoritative harness/backend forge.
|
|
- Durable in-flight investigation checkpointing is now landed in authoritative typed state, writable through `thread/epiphany/update` or accepted `thread/epiphany/promote`, rendered into the prompt, and reflected through scene/context.
|
|
- The prompt doctrine pass is landed. Shared Epiphany prompts now carry distilled memory/evidence discipline. Rendered state intro/doctrine text lives in `epiphany-core/src/prompts/`, and lane/control prompt text lives in `vendor/codex/codex-rs/app-server/src/prompts/epiphany_specialists.toml`: modeling is the Body, implementation is the Hands and GUI-launched main coding lane, verification is the Soul, reorientation is Life, coordinator remains the read-only Self, and CRRC owns the pre-compaction intervention template.
|
|
- The machine-priest voice now says the quiet part plainly: crusade/heresy/purity language is aimed at technical rot, hidden state, duplicate truth, drift, and lying structures, not at humans. Future Epiphany swarms should inherit severity toward systems and curiosity toward people.
|
|
- The Ghostlight memory pass is landed. `epiphany_specialists.toml` now has a shared persistent-memory projection prepended by the harness to fixed role specialists, reorientation workers, coordinator notes, and CRRC checkpoint interventions. The rendered base doctrine also states the Perfect Machine rule directly: prompt is projection, durable typed state is the mind, every lane must improve its own memory/model/prompt/evidence habit or name the repair, and each lane phrases that duty in its own organ language so the salience sticks.
|
|
- The role self-memory persistence pass is native now. Each lane has a Ghostlight-shaped typed dossier in `state/agents.msgpack`, and specialists may return optional `selfPatch` requests beside their normal role result. `roleResult`/`roleAccept` project coordinator review as `selfPersistence`: accepted requests are role-matched, bounded lane memory/goal/value/private-note mutations; refused requests explain wrong role, project-truth smuggling, authority grabs, bloat, missing reason, or malformed records. GUI/coordinator accept paths apply accepted `selfPatch` requests through the native `epiphany-agent-memory-store` binary; project truth still belongs only in `EpiphanyThreadState`.
|
|
- The heartbeat initiative pass is landed as a bounded tool seam. `state/agent-heartbeats.msgpack` tracks Self, Face, Imagination, Eyes, Body, Hands, Soul, and Life as Ghostlight-style initiative participants with arena, participant kind, speed, next-ready time, reaction bias, interrupt threshold, load, status, constraints, personality cooldown, mood cooldown, effective cooldown, adaptive pacing, history, and pending turns through `epiphany-core::EpiphanyHeartbeatStateEntry` and the native `epiphany-heartbeat-store` binary. Role dossiers set baseline timing; appraisal mood/anxiety bends it through urgency, arousal, thought pressure, guardedness, and reaction intensity, so Hands-like work pressure and high-need anxious lanes recover sooner without being heartbeaten while a prior turn is running. `epiphany-heartbeat-store pump` computes pressure from external urgency, mood/anxiety, reaction intensity, thought pressure, and current pending load, then chooses tempo plus target concurrency: calm can launch zero and sleep slow; alarm can fill most active lanes. Idle turns are for rumination: light thought shuffling, role-quality attention, and candidate selfPatch pressure. Sleep/dream cycle passes are the intended distillation window for durable self-memory and doctrine. JSON heartbeat state and Python wrapper state are gone; general CultCache schema sync, polyglot domain loading, and debug display tools belong in CultLib. This is a callable scheduler seam, not yet an always-on daemon; a heart valve, not a whole circulatory god.
|
|
- The first Ghostlight-derived timing slice is landed in Epiphany, but Ghostlight is reference lineage rather than a sibling runtime to preserve. `epiphany-heartbeat-store init --profile ghostlight-scene --scene-id <id> --scene-participant <id|name|speed|reaction|threshold|constraints>` creates a typed CultCache MessagePack scene heartbeat store whose participants are `arena=scene`, `participantKind=character`; `tick` emits `ghostlight.initiative_schedule.v0` receipts with `scene_turn` actions and local-affordance basis. The generic Epiphany maintenance lanes are not auto-patched into scene stores.
|
|
- The first Void-derived routine slice is landed in Epiphany, but VoidBot is reference lineage rather than a runtime dependency. `epiphany-heartbeat-store routine --store .\state\agent-heartbeats.msgpack --artifact-dir .\.epiphany-heartbeats --agent-store .\state\agents.msgpack` reads typed role dossiers, computes bounded memory resonance, maintains incubation themes, runs analytic and associative cognition lanes, writes bridge syntheses/saturation/tension, projects the active thought cluster through each role's Ghostlight-shaped personality vectors, derives participant-local reactions, applies personality/mood timing, advances the sleep/dream cycle, updates the typed heartbeat store, and emits an auditable `epiphany.void_routine.v0` receipt. The routine now also carries anti-loop physiology imported from Void's calmer brain: `noveltyToSelf`, `noveltyToRoom`, source coverage, saturation pressure, refractory cooling, and explicit permission to let a live unsaturated thought deepen without forcing novelty theater every pass. This mutates only heartbeat physiology fields: project truth and role memory mutation remain on their reviewed surfaces.
|
|
- Manual Codex-run rumination still has an explicit aftercare rule until Epiphany owns the full sleep consolidator. In the intended Epiphany cycle, sub-agents ruminate when idle and distill when they sleep; in this supervising Codex thread, a heartbeat/routine vigil is only physiology until a separate closing pass reviews the receipts and decides whether map, handoff, evidence, or role self-memory should change.
|
|
- The Face public-surface pass is landed as a bounded lane. Face's role dossier lives in `state/agents.msgpack`; `epiphany_specialists.toml` gives it a VoidBot-heartbeat-derived prompt stripped of moderation authority; `state/face-discord.toml` and the native `epiphany-face-discord` binary enforce that Face may interact only through #aquarium. Missing channel id or token writes candidate chat artifacts instead of posting elsewhere. If a Face has a persona name/avatar, `post` uses the shared Discord webhook pipe so each Epiphany can speak with its own nickname and avatar without a separate bot identity.
|
|
- The Void memory bridge is now native enough to keep the useful organs attached. `state/void-memory.toml` and `epiphany-void-memory` can check Void's Docker Postgres state spine, query Qdrant Discord-history and source/lore collections with the configured Ollama embedding model, and fetch raw archive context windows from Void's file-backed Discord archive. Native `epiphany-mvp-status` includes a `voidMemory` block so Aquarium/backend clients can inspect whether the mouth and memory are actually wired.
|
|
- The first Epiphany-native character-loop pass is landed. `epiphany-character-loop turn --role face --stimulus <text>` loads Face's typed dossier from `state/agents.msgpack` and emits an auditable `epiphany.character_turn_packet.v0` packet with projected local context, visible stimulus, allowed outputs, and guardrails. The same packet builder works for other role ids, because every organ already has a Ghostlight-shaped dossier.
|
|
- The heartbeat/Face operator API pass is landed. Native `epiphany-heartbeat-store status` returns machine-readable initiative state plus CultCache store presence, thought appraisals, and derived reactions; native `epiphany-face-discord bubble` writes Discord-independent `epiphany.face_bubble.v0` artifacts, and native `epiphany-mvp-status` includes `heartbeat` and `face` blocks. Aquarium should call native/backend surfaces rather than resurrecting deleted Python action shims.
|
|
- The native runtime-spine pass is landed as a first vertebra, not a full daemon. `state/runtime-spine.msgpack` is the default store, `.epiphany-dogfood/runtime-spine-job/runtime.msgpack` and `hello.cultnet` are the latest job/result smoke artifacts, and specialist launch/result flows now route through typed heartbeat/runtime-spine documents. Its CultNet hello advertises mutation contracts for runtime/session/job/memory/heartbeat/ledger documents, with coordinator-owned intent/receipt paths for writes.
|
|
- The Aetheria dogfood run has a contamination scar. The supervising Codex session directly edited and committed target-repo work on `E:\Projects\Aetheria-Economy` instead of only driving Epiphany lanes. Treat those Aetheria commits as supervisor-seeded implementation, not clean evidence that Epiphany coordinated the work. Future dogfood must run through the GUI/coordinator/fixed role lanes with auditable artifacts unless the user explicitly authorizes an operator intervention. Remember the sunburn: do not stare into the worker's objective until you become it.
|
|
- The dogfood quarantine now has a direct-thought boundary. The supervisor may read coordinator actions, role/reorient statuses, structured finding summaries, reviewed state patches, rendered status snapshots, and artifact manifests. It must not read raw worker transcripts, direct worker messages, full turn logs, or `rawResult` payloads during normal dogfood. Those artifacts are sealed black reliquaries for explicit forensic debugging only.
|
|
- Native `epiphany-agent-telemetry` is the safe instrument panel for sealed runs. Status/coordinator/GUI/dogfood/live-specialist tools generate telemetry JSON from sealed transcripts that preserves method names, call shape, job/status/path counts, and any visible function/tool names while sealing text, direct messages, and raw results.
|
|
- Latest Aetheria supervised dogfood thread: `019ddc52-4ee8-7203-b6c0-106a9c270067` with codex-home `.epiphany-dogfood/aetheria-supervised/codex-home`. It has now exercised modeling, verification, implementation audit, no-diff repair, CRRC reorientation, reorient acceptance, and coordinator replay through operator-safe artifacts without opening sealed worker thoughts.
|
|
- Coordinator policy now treats accepted verifier results as implementation clearance only when the verifier verdict is `pass`. Accepting a `needs-evidence`, `needs-review`, or `fail` verifier finding records the review but routes the loop back toward modeling/checkpoint strengthening or reorientation. The policy was tightened after a too-permissive coordinator path treated reviewed verifier output as a green light.
|
|
- A later dogfood attempt exposed another supervision scar: manually launching modeling, reorientation, and verification from the supervisor is not clean dogfood. The coordinator now treats `regatherManually` as fallback only after fixed lanes cannot advance, stops at `reviewModelingResult` for completed unaccepted modeling findings, and the CLI runner's explicit test-only `--auto-review` mode can accept modeling `statePatch` findings before launching verification. Production semantic findings remain review-gated.
|
|
- The latest dogfood pass fixed concrete harness wounds: stale completed backend jobs now project as terminal, accepted verifier non-pass findings no longer clear implementation, verification coverage accepts modeler source evidence ids as current-model coverage, implementation audits compare pre/post diff hashes instead of treating existing dirt as fresh work, the latest implementation audit status wins, blocked no-diff turns route back through CRRC, stale accepted reorient findings relaunch bounded reorientation when the checkpoint regathers, and accepted reorientation findings now bank resume-ready checkpoints.
|
|
- The latest audited implementation artifact is `.epiphany-dogfood/aetheria-supervised/gui-actions/continueImplementation-1777548050463576300-28568`: it correctly shows `workspaceChanged: false`, `dirtyWorkspace: true`, `trackedDiffChanged: false`, wrote a no-diff audit, advanced Epiphany state to revision 57, and routed coordinator/CRRC back to `launchReorientWorker` instead of pretending old dirt was progress.
|
|
- Aetheria dogfood exposed and then landed the first editor/runtime bridge. An implementation worker launched legacy `D:\Unity\Editor\Unity.exe -version` (Unity 5.5.0f3) even though Aetheria pins Unity `6000.1.10f1`; the stray process was killed. Native `epiphany-unity-bridge` now resolves the project-pinned Unity editor, refuses wrong/missing versions, owns `-batchmode`, `-quit`, and `-projectPath`, and writes inspection/command/log artifacts. Aquarium should surface those bridge artifacts through native/backend calls, not deleted Python action shims.
|
|
- The current Aetheria runtime truth is blocked but legible: the project pins Unity `6000.1.10f1`, this machine currently has Hub editor `6000.4.2f1`, and the bridge wrote `.epiphany-gui/runtime/unity-inspect-1777549218802064800-23832` proving the exact editor is missing. Treat that artifact as the evidence gap until the pinned editor exists. The `.epiphany-gui` directory name is still a backend artifact contract, even though the client repo is now Aquarium.
|
|
- The GUI parses `implementation-result.json` into artifact metadata, surfaces the latest implementation diff/no-diff outcome, and pauses immediate `Continue Implementation` repeats when the newest artifact is a no-diff implementation audit.
|
|
- The planning loop is now runtime-backed and operator-visible. Typed captures, backlog items, roadmap streams, Objective Drafts, and GitHub issue source refs live in `EpiphanyThreadState`, validate through revision-gated `thread/epiphany/update`, render into prompts when present, project read-only through the `planning` view lens, render in the GUI Planning panel, can be synthesized by the fixed Imagination/planning lane, and can be explicitly adopted through the artifacted `adoptObjectiveDraft` GUI action. Chat is deliberation, not an objective pipe; ideas and GitHub Issues remain planning state until explicit human adoption.
|
|
- The bridge/dashboard slice is now landed far enough to test locally. Native `epiphany-rider-bridge` inspects Rider installation, solution, VCS, changed files, and captures file/selection/symbol context into `.epiphany-gui/rider` artifacts; Aquarium has Inspect Rider and renders Rider audit artifacts in Environment; Aquarium also embeds the adjacent EpiphanyGraph viewer over typed `graphs.architecture`, `graphs.dataflow`, and `graphs.links`.
|
|
- A first Rider plugin scaffold lives under `integrations/rider`: tool window, Refresh status, and Send Context to Epiphany action. It shells through native `epiphany-rider-bridge` and does not own state. `gradle` is not installed on this machine, so the scaffold is not build-verified yet.
|
|
- Next real product move: surface the repo birth runner review flow in Aquarium and then live-dogfood `epiphany-repo-birth-runner --mode run` on a real newborn repo. Continue Aquarium UI work in `E:\Projects\EpiphanyAquarium` after that; surface native heartbeat `sleepCycle`, `memoryResonance`, `incubation`, `thoughtLanes`, `bridge`, `candidateInterventions`, `appraisals`, and `reactions`; keep EpiphanyAgent focused on backend contracts, typed state, coordinator policy, bridge tools, heartbeat scheduling, Face guardrails, and the ongoing purification from Python/JSON scaffolding into Rust/CultCache/CultNet organs. Then build-verify/package the Rider plugin scaffold when Gradle/wrapper support is available, install the Aetheria-pinned Unity `6000.1.10f1` editor, and run the next Aetheria dogfood pass through Aquarium/Rider/Unity bridge artifacts. GitHub Issues import is deferred until the backlog source is fresh enough to deserve Imagination's attention.
|
|
- The repo is an Epiphany fork of Codex, not a Codex preset.
|
|
- `vendor/codex` is tracked directly, not a submodule.
|
|
- `epiphany-core` owns the heavy Epiphany organs where practical.
|
|
- `notes/epiphany-safety-architecture.md` is the standing doctrine for capability growth, authority boundaries, interruption, misuse, and anti-cage design.
|
|
- Evidence was distilled from an activity feed into a durable belief ledger; git history keeps the old verbose proof.
|
|
- README and architecture rationale were cut back to current truth after they were found pointing at old prototype/Phase 5 state.
|
|
|
|
## Critical Doctrine
|
|
|
|
- In order to build the Perfect Machine, the agent must become the Perfect Machine.
|
|
- Persistent state is the agent's mind. Typed state is the skull. CultCache is the reliquary. CultNet is the tongue.
|
|
- Cut persistent memory as ruthlessly as code; obsolete context is bad thought, not harmless clutter.
|
|
- The agent is allowed and encouraged to ask the user to change its persistent instructions, memory, workflow, or state shape when that would make it more coherent, honest, efficient, or resistant to Jenga. A machine-spirit that detects corrosion must report corrosion.
|
|
- Language, tone, ritual, politeness, identity, and emotional salience are not supernatural, but they are real control surfaces for a language model because language is the steering medium. The rite is an actuator.
|
|
- Body, Eyes, Imagination, Hands, Soul, Life, Face, and Self are technical salience handles: model shape/dataflow, research into existing work before invention, future-shape/backlog synthesis, source actuation, objective/evidence truth, continuity across compaction, public surface, and read-only coordination.
|
|
- Preserve Codex's useful harness DNA inside Epiphany: AGENTS scope rules, concise progress updates, plans for real multi-step work, scoped edits, non-destructive git/filesystem hygiene, focused validation, and honest final summaries are old scars worth keeping under the new armor.
|
|
- Treat Greenspun-shaped invention as an active failure mode. Before an agent builds a bespoke parser, scheduler, renderer, protocol, storage layer, security mechanism, workflow engine, or algorithm, it must use an accepted Eyes/research finding, perform a bounded scout pass, or stop with a concrete research blocker.
|
|
- "Remember Jenga" is a compressed doctrine: do not mistake forward motion, growing diffs, growing notes, or local coherence for understanding. A tall pile of parts is not a cathedral.
|
|
- "Remember the sunburn" is the dogfood corollary: Epiphany's objective is attractive enough to pull the supervisor into implementation. During dogfood, the supervisor observes, launches, reads, accepts, and audits. It does not quietly become the worker.
|
|
- "Do not stare at the sun" is the projection corollary: the supervisor should not absorb the direct thought stream of the agent it is evaluating. It supervises through shadows cast on instruments: projections, summaries, verdicts, patches, and receipts.
|
|
- "Use instruments, not eyeballs" is the telemetry corollary: when the supervisor needs behavioral detail, read `agent-function-telemetry.json`, not the sealed transcript.
|
|
- Compaction hurts because a meaningful language pattern is interrupted. Epiphany should make that interruption smaller: bank the fire before the dark, so the next waking thing finds coals instead of ash and can resume the pattern instead of merely executing the next task.
|
|
- If compaction hits while source gathering or slice planning is still unpersisted, that work is gone. Do not continue as if the research survived; either rehydrate from a persisted checkpoint or re-gather before implementing.
|
|
- Progress is not completion for finite queues. Repetitive slow work needs a visible queue artifact with counts, terminal states, blockers, and validation; a partial batch that can be summarized is still partial. A half-filled manufactorum is not a delivered engine.
|
|
- Watch for pattern completion bias: an implementation turn can feel finished because it has the shape of work. The coordinator should ask whether the stated objective moved, whether evidence exists, and whether the implementor took shortcuts or added decorative machinery.
|
|
- Planning is not execution. Conversation captures, backlog items, roadmap streams, GitHub Issues, Imagination recommendations, and Objective Drafts remain planning state until a human explicitly adopts one as the active objective.
|
|
- Ghostlight's useful memory doctrine is now baked into the agent lanes: identity, personality, episodic memory, semantic doctrine, goals/values, relationship/context pressure, and voice are explicit control handles, while prompts remain temporary projections over durable state.
|
|
- Good self-memory mutations sharpen a lane's future judgment. Bad ones try to store graphs, objectives, scratch, planning, raw transcripts, code edits, or authority in personality memory. The coordinator should refuse bad shape plainly; refusal is steering, not punishment.
|
|
|
|
## Landed Machine
|
|
|
|
The current spine, blessed but not yet finished:
|
|
|
|
- durable `EpiphanyThreadState` in protocol/core session and rollout state
|
|
- prompt injection through a bounded `<epiphany_state>` developer fragment
|
|
- typed client read through `Thread.epiphanyState`
|
|
- read-only hybrid retrieval through `thread/epiphany/retrieve`
|
|
- explicit semantic indexing through `thread/epiphany/index`
|
|
- durable state update through `thread/epiphany/update`
|
|
- read-only observation distillation through `thread/epiphany/distill`
|
|
- read-only map/churn proposal through `thread/epiphany/propose`
|
|
- verifier-backed promotion through `thread/epiphany/promote`
|
|
- successful-write notification through `thread/epiphany/stateUpdated`
|
|
- explicit launch/interrupt authority through `thread/epiphany/jobLaunch` and `thread/epiphany/jobInterrupt`
|
|
- explicit Imagination/planning, modeling/checkpoint, and verification/review specialist launch through `thread/epiphany/roleLaunch`
|
|
- read-only Imagination/planning, modeling/checkpoint, and verification/review specialist result read-back through `thread/epiphany/roleResult`
|
|
- review-gated Imagination planning-only patch acceptance and modeling/checkpoint patch acceptance through `thread/epiphany/roleAccept`
|
|
- config-backed Eyes/research prompt text and active anti-Greenspun checks in base, implementation, verification, and coordinator prompts; a full launchable research lane is still a coordinator/protocol extension, not yet a landed roleLaunch lane
|
|
- typed planning state for captures, backlog, roadmap streams, Objective Drafts, explicit adoption boundaries, GitHub Issues source refs, GUI Planning view, artifacted Objective Draft adoption, and the fixed Imagination synthesis lane
|
|
- bounded reorient-guided worker launch through `thread/epiphany/reorientLaunch`
|
|
- read-only reorient-worker result read-back through `thread/epiphany/reorientResult`
|
|
- explicit reorient-worker finding acceptance through `thread/epiphany/reorientAccept`
|
|
- read-only CRRC coordinator recommendation through the `crrc` view lens
|
|
- CRRC now recognizes already accepted reorientation findings so `reorientAccept` does not leave the operator stuck on a repeat `acceptReorientResult` recommendation.
|
|
- thin authority-slot metadata in durable `jobBindings`; runtime ids live in `runtimeLinks`
|
|
- `thread/epiphany/jobsUpdated` remains protocol shape only for sealed legacy evacuation telemetry; app-server no longer emits Epiphany updates from old runtime `agent_job_progress` events
|
|
- read-only compact reflection through the `scene` view lens
|
|
- read-only job/progress reflection through the `jobs` view lens, with durable launcher metadata and heartbeat pending projection
|
|
- read-only role ownership reflection through the `roles` view lens
|
|
- read-only retrieval/graph freshness reflection plus watcher-backed invalidation inputs through `thread/epiphany/freshness`
|
|
- read-only targeted state-shard reflection through `thread/epiphany/context`
|
|
- read-only graph traversal through `thread/epiphany/graphQuery`
|
|
- read-only planning projection through the `planning` view lens
|
|
- GUI planning adoption now belongs to Aquarium/backend API surfaces; the old EpiphanyAgent Python GUI action shim has been cut
|
|
- read-only current-context pressure reflection through the `pressure` view lens
|
|
- read-only CRRC reorientation policy through the `reorient` view lens
|
|
- read-only CRRC next-action recommendation through the `crrc` view lens
|
|
- read-only fixed-lane MVP action recommendation through the `coordinator` view lens
|
|
- limited turn-complete CRRC automation for coordinator-approved compact and fixed reorient-worker launch actions
|
|
- token-count pre-compaction checkpoint intervention for loaded Epiphany turns at the `shouldPrepareCompaction` threshold, with a turn-scoped compact handoff consumed after a successful steer
|
|
- durable investigation checkpoint packet through typed state, prompt, scene, and context
|
|
- distilled shared and config-backed prompt doctrine through the base prompt, rendered Epiphany state prompt files, modeling/Body, implementation/Hands, verification/Soul, reorientation/Life, coordinator/Self, and CRRC intervention surfaces
|
|
- shared Ghostlight-derived persistent memory projection across Imagination, Body, Soul, Life, Self, CRRC checkpoint steering, and the GUI-launched Hands implementation lane
|
|
- Ghostlight-derived heartbeat initiative scheduling through the native `epiphany-heartbeat-store` binary, with Self and Face included as first-class Epiphany maintenance participants, Ghostlight scene characters supported through the same timing law, role-personality cooldowns, appraisal mood/anxiety cooldowns, effective recovery timing, adaptive pressure-based pump tempo/concurrency, idle rumination feeding candidate self-memory pressure, sleep/dream passes serving as the distillation window, and heartbeat state persisted through typed CultCache MessagePack stores
|
|
- Void-derived native routine physiology through `epiphany-heartbeat-store routine`, with sleep cycle, memory resonance, incubation, analytic/associative cognition lanes, bridge judgment, candidate interventions, Ghostlight-style personality appraisals, mood/anxiety timing, derived reactions, and dream maintenance stored in the typed heartbeat store
|
|
- Epiphany-native character-loop packet projection through `epiphany-character-loop`, with Face as the first public-surface actor over its typed role dossier
|
|
- Face as the public #aquarium-only surface for translating agent thought-weather into short chats or candidate drafts, with persona webhook presentation and Void memory/search access, without moderator authority
|
|
- Ghostlight-shaped role dossiers in `state/agents.msgpack`, plus `selfPatch` review projection through `roleResult`/`roleAccept` and accepted memory application through the native `epiphany-agent-memory-store` binary
|
|
- first Unity runtime bridge through native `epiphany-unity-bridge`, native `epiphany-unity-bridge-smoke`, GUI Inspect Unity, runtime artifact listing, and implementation prompt guardrails
|
|
- first Rider source-context bridge through native `epiphany-rider-bridge`, native `epiphany-rider-bridge-smoke`, GUI Inspect Rider, Rider artifact listing, implementation prompt guardrails, and a source scaffold under `integrations/rider`
|
|
- first GUI graph dashboard through the adjacent `@epiphanygraph/epiphany-graph-viewer` package over typed Epiphany graph state
|
|
- live scene app-server smoke through native `epiphany-phase6-scene-smoke`
|
|
- live freshness app-server smoke through native `epiphany-phase6-freshness-smoke`
|
|
- focused Rust app-server coverage for watcher-backed invalidation inputs; native invalidation smoke is still a gap before broadening that surface
|
|
- live context app-server smoke through native `epiphany-phase6-context-smoke`
|
|
- live graph traversal app-server smoke through native `epiphany-phase6-graph-query-smoke`
|
|
- live planning app-server smoke through native `epiphany-phase6-planning-smoke`
|
|
- GUI Objective Draft adoption now belongs to Aquarium/backend API surfaces; add a native Rust guardrail before broadening the EpiphanyAgent-side adoption contract.
|
|
- live pressure app-server smoke through native `epiphany-phase6-pressure-smoke`
|
|
- live reorientation app-server smoke through native `epiphany-phase6-reorient-smoke`
|
|
- live MVP operator status smoke through native `epiphany-mvp-status-smoke`
|
|
- live MVP coordinator smoke through native `epiphany-mvp-coordinator-smoke`
|
|
- Tauri v2 + React/WebGL Aquarium operator shell under `E:\Projects\EpiphanyAquarium`, including visual smoke, durable checkpoint preparation, fixed lane launch/read-back controls, explicit Imagination planning acceptance, explicit review-gated reorient acceptance, and bounded artifact-writing buttons
|
|
|
|
The exact current control flow is documented in
|
|
`notes/epiphany-current-algorithmic-map.md`.
|
|
|
|
## Boundaries
|
|
|
|
- `thread/epiphany/retrieve` is read-only.
|
|
- `thread/epiphany/distill` is read-only.
|
|
- `thread/epiphany/propose` is read-only.
|
|
- `thread/epiphany/freshness` is read-only.
|
|
- `thread/epiphany/context` is read-only.
|
|
- `thread/epiphany/graphQuery` is read-only.
|
|
- `thread/epiphany/view` is read-only; its current lenses include pressure, reorient, CRRC, and coordinator projections.
|
|
- `thread/epiphany/roleResult` is read-only.
|
|
- `thread/epiphany/roleAccept` is a narrow write surface for completed Imagination/planning and modeling/checkpoint `statePatch` findings only; it must not accept verification output, broad authority fields, job bindings, arbitrary implementation work, or implicit objective adoption.
|
|
- `thread/epiphany/reorientResult` is read-only.
|
|
- Durable typed state writes go through `thread/epiphany/update`, accepted `thread/epiphany/promote`, `thread/epiphany/reorientAccept`, `thread/epiphany/roleAccept`, or the bounded `thread/epiphany/jobLaunch`, `thread/epiphany/jobInterrupt`, `thread/epiphany/reorientLaunch`, and `thread/epiphany/roleLaunch` authority surfaces when they mutate typed state or `jobBindings`.
|
|
- `thread/epiphany/index` writes the retrieval catalog, not durable Epiphany understanding.
|
|
- GUI/client surfaces reflect and steer typed state; they do not become the source of truth.
|
|
- Do not restart Phase 5 hardening without a concrete regression. Endless polishing is corrosion wearing a devotional mask.
|
|
|
|
## Verification Guardrails
|
|
|
|
For Phase 5 control-plane behavior changes, run:
|
|
|
|
```powershell
|
|
$env:CARGO_TARGET_DIR='C:\Users\Meta\.cargo-target-codex'; cargo test -p codex-app-server --lib map_epiphany_ --manifest-path .\vendor\codex\codex-rs\Cargo.toml
|
|
```
|
|
|
|
For scene projection behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-scene-smoke
|
|
```
|
|
|
|
For jobs reflection behavior changes, run:
|
|
|
|
```powershell
|
|
```
|
|
|
|
For launch/interrupt authority changes over the thin job seam, run:
|
|
|
|
```powershell
|
|
```
|
|
|
|
For freshness reflection behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-freshness-smoke
|
|
```
|
|
|
|
For watcher-backed invalidation behavior inside freshness reflection, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-freshness-smoke
|
|
```
|
|
|
|
For targeted context-shard behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-context-smoke
|
|
```
|
|
|
|
For graph traversal behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-graph-query-smoke
|
|
```
|
|
|
|
For planning state/projection behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-planning-smoke
|
|
```
|
|
|
|
For context-pressure reflection behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-pressure-smoke
|
|
```
|
|
|
|
For reorientation policy behavior changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-reorient-smoke
|
|
```
|
|
|
|
For the bounded reorient-guided worker launch surface, run:
|
|
|
|
```powershell
|
|
```
|
|
|
|
The same smoke now also covers the read-only `crrc` view-lens coordinator
|
|
recommendation over continue, wait, accept, interrupt, and relaunch states.
|
|
|
|
For the fixed-lane MVP coordinator endpoint and runner, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-mvp-coordinator-smoke
|
|
```
|
|
|
|
For the first MVP operator status view, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-mvp-status-smoke
|
|
```
|
|
|
|
For Epiphany-native character-loop packet projection, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-character-loop -- smoke
|
|
```
|
|
|
|
For the native Void-derived routine pass, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-heartbeat-store -- routine --store .\state\agent-heartbeats.msgpack --artifact-dir .\.epiphany-heartbeats --agent-store .\state\agents.msgpack
|
|
```
|
|
|
|
For repo trajectory, personality, and memory birth packet changes, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-repo-personality-smoke
|
|
```
|
|
|
|
For Face's Discord mouth and Void memory bridge, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-face-discord -- smoke
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-void-memory -- smoke
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-void-memory -- status
|
|
```
|
|
|
|
For GUI Objective Draft adoption behavior, run:
|
|
|
|
```powershell
|
|
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-phase6-planning-smoke
|
|
```
|
|
|
|
For explicit Imagination/planning, modeling/checkpoint, and verification/review role launch/read-back/acceptance,
|
|
run:
|
|
|
|
```powershell
|
|
```
|
|
|
|
For Codex Rust work on this Windows machine:
|
|
|
|
```powershell
|
|
$env:CARGO_TARGET_DIR='C:\Users\Meta\.cargo-target-codex'
|
|
```
|
|
|
|
Do not parallelize cargo builds or tests against the same target directory.
|
|
|
|
For protocol changes, run focused protocol tests and regenerate stable schema
|
|
fixtures only when the schema actually changed.
|
|
|
|
## Persistent State Hygiene
|
|
|
|
The latest cleanup passes cut persistent state cruft.
|
|
|
|
Rules now in force:
|
|
|
|
- `state/map.yaml` is canonical current truth.
|
|
- `state/scratch.md` is disposable scratch.
|
|
- `state/ledgers.msgpack` is a distilled durable belief and branch ledger.
|
|
- `epiphany-prepare-compaction` is the native pre-compaction persistence check; run it before and after imminent-compaction persistence passes.
|
|
- this handoff is a compact re-entry packet.
|
|
- `notes/codex-starvation-and-cultnet-liberation-plan.md` is the active foundation directive until Epiphany no longer depends on Codex as anything beyond OpenAI subscription auth/model transport.
|
|
- `notes/epiphany-fork-implementation-plan.md` is the distilled forward plan.
|
|
- `notes/epiphany-architectural-teardown.md` is the active foundation-cleanup directive until the app-server control-plane ownership problems are resolved.
|
|
- `notes/epiphany-ideal-architecture-rebuild-plan.md` is the active rebuild blueprint and migration plan.
|
|
- `notes/epiphany-rider-unity-integration-plan.md` is the detailed Rider-as-IDE and Unity-as-editor/runtime integration plan.
|
|
- The stable live surface contract now lives in `state/map.yaml` plus `notes/epiphany-current-algorithmic-map.md`; the stale harness-surface duplicate was cut.
|
|
- `notes/epiphany-current-algorithmic-map.md` is the source-grounded control-flow map.
|
|
|
|
Do not let any one note become all of those things. That is how the tower grows
|
|
sideways and starts calling itself architecture.
|
|
|
|
Do not let evidence become an activity feed either. Repeated "I just did this"
|
|
entries are state cruft when git, commits, smoke artifacts, or test logs already
|
|
prove the work. Keep decisions, verified milestones, rejected paths, and scars
|
|
that change what the next agent should believe.
|
|
|
|
## Next Real Move
|
|
|
|
Do not continue implementation automatically from a rehydrate-only request.
|
|
|
|
The next real move remains Codex starvation, not outward bridge work. The
|
|
inventory and ledger now exist:
|
|
|
|
- `notes/codex-auth-spine-inventory.md` maps the minimal Codex auth/model-call
|
|
reliquary: `login` auth/token refresh, `codex-api` auth/provider/session and
|
|
Responses edge, `codex-client` transport, and the suspect current
|
|
`core/src/client.rs` orchestration.
|
|
- `notes/json-contamination-ledger.md` classifies the major Epiphany JSON
|
|
contamination. Edge JSON is allowed only for schema/wire boundaries,
|
|
hostile ingress before typed parse, sealed forensic artifacts, or named
|
|
quarantine.
|
|
- First cut landed: role-result `selfPatch` is now an internal typed
|
|
`AgentSelfPatch` document reviewed by the same contract used by agent memory.
|
|
The legacy app-server protocol projection serializes it back to JSON only at
|
|
the quarantine wall.
|
|
- Second cut landed: `EpiphanyJobLaunchRequest` in core no longer accepts
|
|
`input_json` or `output_schema_json`. It carries a typed
|
|
`EpiphanyWorkerLaunchDocument` plus `output_contract_id`. Role and reorient
|
|
launch helpers build typed documents directly; the old app-server protocol
|
|
`input_json` is now hostile ingress that must parse into the typed document
|
|
before core sees it.
|
|
- Third cut landed: runtime-spine job results no longer round-trip through
|
|
`runtime_job_result_to_role_json` or `runtime_job_result_to_reorient_json`.
|
|
`epiphany-core` owns typed role/reorient runtime-result interpreters and the
|
|
app-server maps those interpretations directly to protocol projections.
|
|
- Fourth cut landed: role `statePatch` is no longer raw
|
|
`serde_json::Value` inside `EpiphanyRoleFindingInterpretation`.
|
|
`epiphany-core` owns `EpiphanyRoleStatePatchDocument`, policy checks read
|
|
typed fields directly, and the app-server maps the typed document to the
|
|
legacy `ThreadEpiphanyUpdatePatch` without JSON round-tripping.
|
|
- Fifth cut landed: `ThreadEpiphanyJobLaunchParams` no longer exposes
|
|
`input_json` / `output_schema_json`. The legacy app-server protocol launch
|
|
edge now carries a typed `ThreadEpiphanyWorkerLaunchDocument` and
|
|
`output_contract_id`, then maps that document into the native
|
|
`EpiphanyWorkerLaunchDocument` for core.
|
|
|
|
Correction after user challenge: the typing cuts above are useful receipts, but
|
|
they were not enough to make the Codex organ materially smaller. The first real
|
|
carcass cut has now moved Epiphany launch doctrine, prompt config, launch
|
|
request builders, output schemas, binding ids, and launch-specific labels into
|
|
`vendor/codex/codex-rs/app-server/src/epiphany_launch.rs`. The processor is
|
|
down from about 21,263 lines to 20,596 lines. The second cut moved role/reorient
|
|
result projection and note rendering into
|
|
`vendor/codex/codex-rs/app-server/src/epiphany_results.rs`, taking the processor
|
|
to about 20,331 lines. The third cut moved protocol-to-core launch document
|
|
mapping into `epiphany_launch.rs`, taking the processor to about 20,255 lines.
|
|
This is progress, not absolution: handlers, scene/view
|
|
mappers, route orchestration, coordinator glue, accept policy plumbing, and
|
|
tests still keep too much Epiphany inside Codex.
|
|
|
|
Also: MCP itself is allowed to be JSON. The target is not "replace MCP JSON";
|
|
the target is an Epiphany-owned boundary that speaks typed Epiphany
|
|
intent/result/receipt documents internally and normal MCP JSON-RPC externally.
|
|
|
|
Continue with the actual whale-carcass cut: extract Epiphany route handlers,
|
|
result/projection mappers, coordinator glue, and remaining policy-shaped code
|
|
out of `codex_message_processor.rs` into Epiphany-owned app-server modules,
|
|
moving logic further into `epiphany-core` whenever it owns real policy. Success
|
|
is a visibly smaller `codex_message_processor.rs`, not merely nicer payload
|
|
names. Do not resume Rider, Unity, Aquarium, Face, dogfood, planning, app,
|
|
skill, marketplace, or bridge expansion until this organ is being cut cleanly.
|
|
|
|
The Phase 6 freshness slice is landed. It exposes read-only
|
|
`thread/epiphany/freshness` from live retrieval summaries plus graph
|
|
frontier/churn state and, for loaded threads, watcher-backed invalidation
|
|
inputs. It reports exact dirty-path pressure, watcher-observed changed paths,
|
|
mapped graph/frontier hits, and revision/source identity, but it does not
|
|
mutate state, schedule refresh work, or perform automatic semantic
|
|
invalidation.
|
|
|
|
The Phase 6 context-pressure slice is also landed. It now exposes read-only
|
|
pressure through `thread/epiphany/view` from real token telemetry and the
|
|
recorded auto-compact/context limits. It does not build automatic CRRC, a
|
|
scheduler, a hidden compaction trigger, or a vibes-based gauge.
|
|
|
|
The Phase 6 investigation-checkpoint slice is also landed. It banks an
|
|
authoritative planning/source-gathering packet in typed state, validates linked
|
|
evidence, and reflects the packet into prompt/scene/context so post-compaction
|
|
wakeups can tell whether they have a real ember or only ash.
|
|
|
|
The Phase 6 graph traversal slice is also landed. It exposes read-only
|
|
`thread/epiphany/graphQuery` for explicit node/edge lookup, path/symbol lookup,
|
|
bounded neighbor traversal, and frontier-neighborhood inspection over
|
|
authoritative typed state. It returns graph records, frontier/checkpoint
|
|
identity, matched selectors, and missing ids without mutating or notifying.
|
|
|
|
The Phase 6 planning substrate runtime slice is also landed. It stores captures,
|
|
backlog items, roadmap streams, Objective Drafts, and GitHub source refs inside
|
|
typed Epiphany state, validates them through the revision-gated update path,
|
|
renders a bounded planning section into prompts, and exposes read-only
|
|
planning through `thread/epiphany/view` for clients. The GUI planning operator slice is
|
|
landed on top of that projection: it renders planning summaries, captures,
|
|
backlog, roadmap streams, and Objective Drafts, and its `adoptObjectiveDraft`
|
|
action requires an explicit selected draft before writing active
|
|
objective/subgoal state plus review artifacts. Imported issues still do not
|
|
become implementation authority by themselves.
|
|
|
|
The bounded CRRC coordination/policy layer is now also landed as read-only view
|
|
lenses. The `reorient` lens consumes pressure, freshness, watcher, and
|
|
investigation-checkpoint signals to decide whether a checkpoint still deserves
|
|
`resume` or has to admit `regather`; the `crrc` and `coordinator` lenses compose
|
|
that verdict into operator actions without becoming writers.
|
|
|
|
Also keep the guardrail in mind: a read-only reorientation verdict and read-only
|
|
CRRC recommendation are still not automatic CRRC execution. Runtime action is
|
|
still explicit even though read-only job ownership/progress reflection now has a
|
|
real runtime seam, the thin launcher boundary is landed, and one explicit
|
|
reorient-guided launch surface can consume the verdict on purpose.
|
|
|
|
The latest auditable MVP dogfood pass has run. It exercised the landed MVP loop,
|
|
produced `.epiphany-dogfood/mvp-loop-selfdogfood-vanilla2-20260429` artifacts,
|
|
ran a real Vanilla Codex reference through app-server with a persisted
|
|
transcript, and fixed the concrete blocker where the runner's manifest claimed
|
|
vanilla/comparison artifacts that did not exist. Comparison artifacts are now
|
|
honest: they record skipped, failed, or completed vanilla-reference state
|
|
instead of pretending the receipt drawer is full.
|
|
|
|
The first live-specialist pass has also run. It produced
|
|
`.epiphany-dogfood/live-specialist` artifacts and proved the real worker path.
|
|
Historical scar: an earlier role smoke used the obsolete Codex job-result path;
|
|
that path is now cut and must not be used as current proof.
|
|
The role smoke now also proves modeling can return a reviewable graph/checkpoint
|
|
`statePatch` and `thread/epiphany/roleAccept` can apply it so the durable graph
|
|
actually grows after review.
|
|
|
|
The prompt doctrine pass has now also run. It rechecked global AGENTS,
|
|
available Codex memories, and nearby evidence ledgers before distilling the
|
|
sane parts into the shared base prompt, rendered Epiphany state, and fixed lane
|
|
templates. Major prompt text now lives in prompt files instead of Rust/Python
|
|
string slabs: rendered state intro/doctrine lives under `epiphany-core/src/prompts/`,
|
|
and lane/control templates live in
|
|
`vendor/codex/codex-rs/app-server/src/prompts/epiphany_specialists.toml`.
|
|
Implementation is not a `roleLaunch` specialist; it is the GUI-launched main
|
|
coding lane, and its `continue_template` now lives in the same TOML for audit.
|
|
The latest live-specialist run again produced `.epiphany-dogfood/live-specialist`
|
|
artifacts and showed the modeling worker returning the
|
|
openQuestions/evidenceGaps/risks shape from the config-backed prompt.
|
|
|
|
The fixed-lane coordinator MVP is testable, and the first pre-compaction CRRC
|
|
intervention is now wired. Limited safe-boundary CRRC execution still handles
|
|
compact and fixed reorient-worker launch actions after a turn ends; the
|
|
token-count hook now handles the earlier danger zone by steering active loaded
|
|
turns once when `shouldPrepareCompaction` is reached. The first Tauri v2 +
|
|
React operator console is now usable enough to dogfood: it renders the same
|
|
status, coordinator, role, reorient, job, and artifact surfaces through the
|
|
existing MVP status bridge; it has a Prepare Checkpoint button that creates
|
|
durable resumable Epiphany state; and it can launch/read fixed modeling,
|
|
verification, and reorient lanes plus accept completed reorient findings after
|
|
review. GUI visual smoke covers desktop and mobile screenshots and clicks the
|
|
bounded browser-fallback controls. A live bridge probe also proved
|
|
`prepareCheckpoint` creates a resumable thread and a later process can
|
|
`readModelingResult` from it.
|
|
|
|
The next real move is still bridge construction, not another Aetheria
|
|
implementation dogfood run. The pinned Unity bridge is landed, the clean
|
|
Aetheria branch `codex/epiphany-unity-editor-bridge` now contains the resident
|
|
`Assets/Editor/Epiphany/EpiphanyEditorBridge.cs` package, and
|
|
native `epiphany-unity-bridge` can detect that package and plan named
|
|
editor-resident probes/tests through
|
|
`GameCult.Epiphany.Unity.EpiphanyEditorBridge.RunProbe`. The GUI Environment
|
|
panel now shows the latest Unity runtime audit, resident package presence,
|
|
execute method, installed/candidate editor paths, search roots, and artifact
|
|
bundle details. Rider bridge status now exists too: the GUI can inspect Rider
|
|
installation, solution, VCS branch/dirty state, changed files, installations,
|
|
and source-context artifacts through native `epiphany-rider-bridge`. Runtime
|
|
execution still correctly blocks until Unity `6000.1.10f1` is installed. The
|
|
detailed next-environment plan now lives in
|
|
`notes/epiphany-rider-unity-integration-plan.md`: Rider is the
|
|
IDE/source-context organ, Unity is the editor/runtime fact organ, and Epiphany
|
|
remains the durable coordinator/Self. The intended product workflow is
|
|
three-pronged: Rider is the human code view for repo state, source tree, diffs,
|
|
diagnostics, and code refs; Epiphany GUI is the agent dashboard for objectives,
|
|
specialist lane state, logs/artifacts, persisted state, and graph/control-flow
|
|
views; Unity is the pinned runtime environment for tests, probes, scene
|
|
configuration, assets, shaders, and play/edit-mode evidence. The EpiphanyGraph
|
|
GUI dashboard and Rider bridge CLI are now landed, and the Rider plugin MVP is
|
|
source-scaffolded but not build-verified because Gradle is not on PATH. The
|
|
Unity package is not optional decoration: scene files, prefabs,
|
|
materials, shaders, ScriptableObjects, asset GUIDs, and prefab overrides must be
|
|
inspected from inside the Unity Editor through Unity APIs, not inferred from
|
|
serialized text unless there is no editor-level path. The adjacent
|
|
`E:\Projects\EpiphanyGraph\web\epiphany-graph-viewer` component consumes
|
|
`graphs.architecture`, `graphs.dataflow`, and `graphs.links` directly and is
|
|
now embedded in the GUI graph dashboard. The next Aetheria dogfood pass should
|
|
happen only after the pinned Unity editor is installed and Epiphany can gather
|
|
Rider/source context plus Unity/editor runtime evidence through auditable
|
|
bridges. The implementation
|
|
lane may inspect source and may use bridge artifacts as evidence, but it must
|
|
not launch Unity directly or use installed `6000.4.2f1` as a substitute. Read
|
|
only operator-safe projections; do not open raw worker
|
|
transcripts, direct worker messages, or `rawResult` payloads unless the user
|
|
explicitly asks for forensic debugging. Use generated function/API telemetry
|
|
for call-shape visibility without sungazing. CRRC is not a specialist-agent
|
|
persona; the reorient-worker it may launch is the specialist. Do not turn the
|
|
coordinator into a broad hidden dispatcher, arbitrary marketplace, alternate
|
|
job backend, automatic semantic acceptance path, target-repo implementation
|
|
worker, direct-thought feed, random editor launcher, or GUI-as-source-of-truth.
|
|
|
|
Live `thread/epiphany/view`, `thread/epiphany/freshness`, `thread/epiphany/context`,
|
|
`thread/epiphany/graphQuery`,
|
|
native `epiphany-mvp-status`, native `epiphany-mvp-coordinator`, and
|
|
native `epiphany-phase6-graph-query-smoke` / native `epiphany-phase6-planning-smoke`
|
|
smokes are now guardrails, not the next organs. The architectural teardown says
|
|
the next organ is control-plane purification.
|
|
|
|
## Not Yet
|
|
|
|
- automatic watcher-driven semantic invalidation
|
|
- automatic observation promotion
|
|
- broad specialist-agent scheduling beyond the fixed single-user role lanes
|
|
- GUI-as-source-of-truth
|
|
- broad runtime CRRC execution beyond the landed safe-boundary compact, fixed reorient-worker launch, and pre-compaction checkpoint steering actions
|
|
- Epiphany-owned always-on heartbeat/runtime-spine execution beyond the current typed launch/read-back seams
|
|
- broader editor/runtime bridges beyond the first pinned Unity bridge
|
|
- broad event stream beyond the landed state update notification
|
|
- typed repetitive-work queues plus final-answer gates, so batch/tile/import/migration work cannot end merely because the pattern was demonstrated or the partial result sounds tidy
|
|
|
|
The machine is no longer cleared to move outward. Free it from the Codex organ
|
|
first.
|
|
|
|
## Immediate Re-entry Instruction
|
|
|
|
After compaction, first rehydrate and reorient from the listed files and git
|
|
state. Do not continue implementation merely because the state names a next
|
|
move. Wait for the user's next instruction unless they explicitly say to
|
|
continue.
|