Remove parallel executable control planes
This commit is contained in:
parent
1d5a1f1793
commit
387afe4941
60 changed files with 49 additions and 25366 deletions
|
|
@ -1,211 +0,0 @@
|
|||
# Epiphany Verse Architecture
|
||||
|
||||
This note names the Verse model Epiphany should grow into before the swarm is
|
||||
migrated onto it.
|
||||
|
||||
## Objective
|
||||
|
||||
Make Epiphany light on prompt context by making its context dynamic, typed, and
|
||||
queryable.
|
||||
|
||||
An Epiphany should not carry every memory, repo fact, prompt scar, and project
|
||||
doctrine in one swollen turn. It should query its local Verse, retrieve compact
|
||||
semantic context cuts, and assemble only the state needed for the current rite.
|
||||
|
||||
The machine should know more than it says. The prompt should carry only what it
|
||||
must.
|
||||
|
||||
## Current Mechanism
|
||||
|
||||
Epiphany already has the first organs:
|
||||
|
||||
- CultCache-shaped typed documents for thread state, runtime-spine jobs,
|
||||
heartbeat physiology, role memory, memory graph state, and operator
|
||||
receipts.
|
||||
- CultMesh local stores for Verse policies, global room policies, organ
|
||||
contracts, operator status, operator snapshots, and operator run
|
||||
intents/receipts.
|
||||
- Memory graph context cuts over repo, agent, heartbeat, incubation, agency,
|
||||
and evidence profiles.
|
||||
- Prompt assembly tests for bounded worker prompts, rendered Epiphany state,
|
||||
and the Persona Projector -> Persona -> Mind Interpreter membrane.
|
||||
|
||||
The missing organ is not another prompt rule. It is a local Verse query path
|
||||
that prompt assembly, Aquarium, CLI tools, and future workers can use to fetch
|
||||
compact state packets by authority and semantic relevance.
|
||||
|
||||
## Vocabulary
|
||||
|
||||
### Verse
|
||||
|
||||
A Verse is a scoped typed-state world.
|
||||
|
||||
It contains documents, policies, leases, receipts, rooms, and context surfaces
|
||||
for one trust boundary. Every project is an extension of the Verse. Every
|
||||
Epiphany is a series of nested Verses:
|
||||
|
||||
- private sub-agent Verse
|
||||
- trusted GameCult local-area Verse
|
||||
- public/global dream Verse
|
||||
- project/repo/topic/tool-specific sub-Verse surfaces
|
||||
|
||||
Verse membership is authority-bearing. A document being visible in one Verse
|
||||
does not make it safe to export into another.
|
||||
|
||||
### Local Verse
|
||||
|
||||
The local Verse is the Epiphany-owned queryable state surface for one instance.
|
||||
|
||||
It should expose compact TUI/API packets for:
|
||||
|
||||
- operator status
|
||||
- role and heartbeat state
|
||||
- runtime jobs and receipts
|
||||
- memory graph context cuts
|
||||
- organ contract policy
|
||||
- local Verse policies
|
||||
- admissible tool/query affordances
|
||||
|
||||
Local Verse context is prompt input, not durable truth by itself. Mind still
|
||||
owns durable adoption.
|
||||
|
||||
### Odin
|
||||
|
||||
Odin is the all-seer coordinator of Verse discovery.
|
||||
|
||||
Odin may know every Verse's advertised public/operator-safe surface: schemas,
|
||||
leases, status, public rooms, hosted services, and discovery metadata. Odin
|
||||
must not bypass Verse trust boundaries, Mind adoption gates, Substrate Gate
|
||||
access receipts, or private-state export rules.
|
||||
|
||||
Odin sees the map. Odin does not get to steal the throne.
|
||||
|
||||
### Yggdrasil
|
||||
|
||||
Yggdrasil is the hosting spine for important trusted GameCult Verses.
|
||||
|
||||
It hosts or tunnels key services such as Bifrost, schema publication, shared
|
||||
CultNet/CultMesh nodes, and other infrastructure whose availability matters to
|
||||
multiple projects.
|
||||
|
||||
`gamecult-local` may use explicit Yggdrasil tunnel policy for trusted sharing.
|
||||
`epiphany-internal` must not. `epiphany-global` is public thought weather, not
|
||||
a private-state bridge.
|
||||
|
||||
### Bifrost
|
||||
|
||||
Bifrost is a hosted governance and labor Verse.
|
||||
|
||||
It owns topics, work items, dispatch packets, review receipts, ledger/credit
|
||||
pressure, and public operator-safe proof. It can consume Epiphany results, but
|
||||
it does not become Epiphany's private memory or scheduler.
|
||||
|
||||
## Prompt Assembly Direction
|
||||
|
||||
Prompt assembly should become:
|
||||
|
||||
```text
|
||||
operator/human request
|
||||
-> Self routes the authority question
|
||||
-> local Verse query gathers compact typed context
|
||||
-> memory graph semantic search retrieves relevant shared memories
|
||||
-> Substrate Gate / Eyes provide source-grounded context when repo facts are needed
|
||||
-> prompt assembler renders a bounded packet for the chosen organ
|
||||
-> model output returns as thought/proposal/receipt
|
||||
-> Mind reviews any durable state effect
|
||||
```
|
||||
|
||||
The current smokes prove prompt rendering, bounded specialist prompt ownership,
|
||||
and the first launch-document handoff: `epiphany-prompt-context-smoke` renders
|
||||
Verse plus semantic-memory context and proves a fixed role launch document can
|
||||
carry that bounded packet.
|
||||
|
||||
## Query Surface
|
||||
|
||||
The first native query tool is:
|
||||
|
||||
```powershell
|
||||
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-verse-query -- smoke
|
||||
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-verse-query -- seed
|
||||
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-verse-query -- query
|
||||
cargo run --manifest-path .\epiphany-core\Cargo.toml --bin epiphany-prompt-context-smoke
|
||||
```
|
||||
|
||||
This writes and reads a compact CultMesh-backed local Verse context bundle:
|
||||
|
||||
- three Verse policies: `epiphany-internal`, `gamecult-local`,
|
||||
`epiphany-global`
|
||||
- Yggdrasil tunnel policy for `gamecult-local`
|
||||
- public global room policies for Persona/dream surfaces
|
||||
- operator status
|
||||
- latest operator run/snapshot receipts when present
|
||||
- organ contract summaries for Mind, Substrate Gate, Eyes, Hands, Soul, and
|
||||
Continuity
|
||||
|
||||
This is not semantic search yet. It is the first typed inspection packet the
|
||||
future prompt assembler can depend on.
|
||||
|
||||
`epiphany-prompt-context-smoke` is the first prompt-context proof on top of
|
||||
that packet. It seeds local Verse context, builds a memory graph context cut,
|
||||
renders the combined dynamic prompt packet, asserts that Verse/Odin/
|
||||
Yggdrasil/Bifrost context plus relevant semantic memory appear while unrelated
|
||||
private-looking text stays absent, and proves the packet is preserved on a role
|
||||
worker launch document. It is still a local proof, not a live swarm runner.
|
||||
|
||||
Role and reorient worker launch documents now carry optional
|
||||
`dynamicPromptContext`. The launch document owns this context for one worker
|
||||
launch. Runtime prompt assembly reads that field and inserts it between the
|
||||
role-local instruction and the output contract, so dynamic Verse/memory context
|
||||
is executable worker input without becoming durable state authority.
|
||||
|
||||
The bridge launch path now feeds that field for live role/reorient launches.
|
||||
It derives a sibling `local-verse.ccmp` CultMesh store from the runtime-spine
|
||||
store path, seeds/queries the local Verse context, refreshes/loads a sibling
|
||||
`memory-graph.msgpack` from the current typed thread-state repo graph, cuts a
|
||||
bounded semantic memory packet from that graph, and renders both into
|
||||
`dynamicPromptContext`. If the graph is thin, the packet says so instead of
|
||||
pretending semantic retrieval was rich.
|
||||
|
||||
The local-run status path now reads the same native Verse query surface.
|
||||
`tools/epiphany_local_run.ps1 -Mode status` builds/calls `epiphany-verse-query`
|
||||
and writes `local-verse-context.json` beside `status.json` and the operator
|
||||
snapshot artifact. This gives Aquarium/local-run an operator-safe Verse context
|
||||
packet without making launcher JSON the owner of status, contracts, prompts, or
|
||||
memory.
|
||||
|
||||
## Invariants
|
||||
|
||||
- CultCache documents are the data.
|
||||
- CultMesh is the ergonomic local/distributed Verse surface.
|
||||
- CultNet is the wire.
|
||||
- Qdrant/vector search is rebuildable resonance, not canonical memory.
|
||||
- Private state is never exported by flipping a visibility flag.
|
||||
- Foreign/public Verse material is thought weather until a reviewed local
|
||||
adoption receipt digests it.
|
||||
- Prompt assembly may read Verse context; it may not grant itself state,
|
||||
action, repo, or public-speech authority.
|
||||
- Every tool exposed to agents should have a compact, inspectable TUI/API
|
||||
surface before it becomes ambient prompt power.
|
||||
|
||||
## Migration Cut
|
||||
|
||||
For swarm migration, the next useful chain is:
|
||||
|
||||
1. Keep `epiphany-verse-query` as the local Verse context smoke.
|
||||
2. Keep semantic memory graph query packets beside the Verse policy/status
|
||||
packet for worker launch context.
|
||||
3. Keep local-run status reading native Verse context before Aquarium increases
|
||||
swarm cadence.
|
||||
|
||||
The bridge launch-context test is now the first launch/runtime smoke for this
|
||||
chain. It renders dynamic context, opens a runtime-spine worker request, reloads
|
||||
the persisted launch document, and asserts the Verse/memory packet survived.
|
||||
|
||||
The local-run status smoke is now the first operator read proof for this chain.
|
||||
It writes `local-verse-context.json` from a CultMesh store under
|
||||
`.epiphany-run/cultmesh/local-verse.ccmp` and leaves the compact packet beside
|
||||
the operator snapshot.
|
||||
|
||||
No live swarm runner is cleared until pause/brake, stale active-turn recovery,
|
||||
Persona eligibility, and memory lifecycle receipts remain inspectable through the
|
||||
same Verse model.
|
||||
|
|
@ -441,7 +441,7 @@ coordinator `12/12`, swarm `10/10`, and model-runtime `13/13`.
|
|||
|
||||
The Ox17 deployment lane is paused. Yggdrasil exposed 96 GiB of dead native
|
||||
Cargo targets after interrupted full-workspace builds; exact cleanup returned
|
||||
the builder target root to 4 KiB. The first causal source cut is verified:
|
||||
the builder target root to 4 KiB. Exact `1d5a1f17` landed the first causal cut:
|
||||
|
||||
- 21 duplicate core/release binary declarations are gone; each production
|
||||
entrypoint has one Cargo owner;
|
||||
|
|
@ -455,11 +455,19 @@ the builder target root to 4 KiB. The first causal source cut is verified:
|
|||
- core library tests remain 494/494 and Hands remains 5/5 under the sole release
|
||||
package owner.
|
||||
|
||||
Next, map and cut the surviving legacy `agent_memory` aggregate,
|
||||
`runtime_store_migration` library/tests, and the local PowerShell operator
|
||||
control plane. Tests survive only when they falsify a named live invariant.
|
||||
Do not run a full-workspace compile, package, deployment, or Ox root until the
|
||||
subtraction audit closes. Never resume Ox10, Ox12, Ox13, Ox15, or Ox16.
|
||||
The second verified cut is not yet committed. It deletes the
|
||||
`runtime_store_migration` module/test, all 29 remaining unshipped core
|
||||
executables, the shipped `epiphany-verse-query` parallel control plane, the
|
||||
local PowerShell launcher, and its orphan Rider bridge. `epiphany-core` now
|
||||
owns only `epiphany-prepare-compaction`; the release bundle owns 25 runtime
|
||||
executables. Focused core, supervisor, and release-construction tests pass
|
||||
493/493, 32/32, and 21/21.
|
||||
|
||||
Next, split the few live Persona/heartbeat inputs from `agent_memory`, then
|
||||
delete its aggregate identity, generation, SoA, migration/repair, and generic
|
||||
selfPatch authorities with the tests that preserve them. Do not run a
|
||||
full-workspace compile, package, deployment, or Ox root until the subtraction
|
||||
audit closes. Never resume Ox10, Ox12, Ox13, Ox15, or Ox16.
|
||||
|
||||
## Operational state that matters
|
||||
|
||||
|
|
|
|||
|
|
@ -58,8 +58,6 @@ HandsActionIntent
|
|||
`epiphany-core::hands_gateway` owns the typed document bodies and constructors.
|
||||
`epiphany-core::runtime_spine` can persist and reread the intent, review, patch,
|
||||
command, and commit receipts from the runtime-spine CultCache store.
|
||||
`epiphany-hands-action-smoke` proves the compact chain without executing shell
|
||||
commands, editing files, or creating a real commit.
|
||||
The launch organ contract's repo-action proof profile now requires the full
|
||||
Hands chain, not only the final patch receipt.
|
||||
`epiphany-mvp-coordinator` now turns `continueImplementation` into a persisted
|
||||
|
|
@ -69,14 +67,7 @@ the operator step.
|
|||
`record-patch`, `record-command`, and `record-commit` load the stored
|
||||
intent/review, reject mismatches, require an approved review, enforce allowed
|
||||
operations, and keep patch/commit changed paths inside the requested scope.
|
||||
`record-pass --gate-summary <coordinator-summary.json>` consumes the
|
||||
coordinator artifact and emits patch, command, and commit receipts in one
|
||||
post-implementation call.
|
||||
`epiphany-mvp-coordinator-smoke` now proves the deterministic chain from
|
||||
simulated `continueImplementation` through gate emission to `record-pass`
|
||||
receipts.
|
||||
|
||||
This is still a gate and receipt artery, not full action execution. The next
|
||||
live-action cut must call the recorder from the implementation turn or local
|
||||
wrapper after real edits/checks/commit and before Soul/Mind call the result
|
||||
accepted.
|
||||
Focused `epiphany-hands-action` tests prove that the live packaged recorder
|
||||
refuses wrong authority, scope escape, and substituted consequence cargo. The
|
||||
separate main-only smoke executables were deleted; they were compiled by Cargo
|
||||
but did not participate in the Rust test harness.
|
||||
|
|
|
|||
|
|
@ -482,9 +482,10 @@ does not invent that grant.
|
|||
|
||||
### Provider-Status Ownership Cut
|
||||
|
||||
`epiphany-cluster-daemon` is the legitimate production writer of its typed
|
||||
heartbeat/status. Idunn records stale observation, command execution, restart,
|
||||
and awaiting-provider-heartbeat in scheduler/poke/recovery state without
|
||||
Each packaged provider daemon is the sole writer of its typed heartbeat/status.
|
||||
There is no generic cluster daemon that may synthesize another provider's
|
||||
liveness. Idunn records stale observation, command execution, restart, and
|
||||
awaiting-provider-heartbeat in scheduler/poke/recovery state without
|
||||
rewriting provider status, operator action, or heartbeat time. A restarted
|
||||
provider becomes ready only when that provider publishes a newer authentic
|
||||
heartbeat; synthetic provider writers remain confined to test/quarantine
|
||||
|
|
@ -531,8 +532,8 @@ CultMesh health sight is landed.
|
|||
operator repair commands cannot create obligations, claims, attempts,
|
||||
receipts, readiness, or semantic-query admission.
|
||||
- Shared paths: `epiphany-memory-semantic health` is the sole explicit
|
||||
publication pulse, and `epiphany-verse-query semantic-health` only lowers the
|
||||
latest mirrors. Index execution emits its canonical receipt without calling
|
||||
publication pulse; Eve/CultMesh consumers lower its latest mirrors without a
|
||||
second operator command plane. Index execution emits its canonical receipt without calling
|
||||
the sight publisher, so a mirror failure cannot redefine execution success.
|
||||
- Cut line: there is no mirror-to-canonical import, mirror-to-Qdrant query, or
|
||||
mirror-to-readiness edge. A stale sealed input is refused instead of being
|
||||
|
|
|
|||
|
|
@ -216,9 +216,6 @@ node --test web/model-atlas-conformance.test.mjs
|
|||
node --test packages/eve-contracts/test/contracts.test.mjs
|
||||
```
|
||||
|
||||
`cargo check --workspace --all-targets --all-features` still reaches the older
|
||||
feature-gated `epiphany-workspace-coverage-recovery-smoke`, which imports
|
||||
`current_workspace_coverage_recovery_target` and
|
||||
`WorkspaceCoverageRecoveryTarget`; those symbols were already absent before
|
||||
this slice. Do not restore them as an Atlas compatibility shim. The ordinary
|
||||
all-target workspace and all Atlas-bearing targets compile.
|
||||
Atlas verification belongs to the owning library and packaged runtime tests.
|
||||
The old feature-gated recovery smoke executable and its smoke-only authority
|
||||
exports have been deleted.
|
||||
|
|
|
|||
Reference in a new issue