Map standalone Codex transport migration
This commit is contained in:
parent
f532c3ad00
commit
c873bef3b1
6 changed files with 304 additions and 3 deletions
|
|
@ -658,6 +658,18 @@ route, not a tool route plus a parallel no-tools opinion. The remaining broad
|
|||
`codex-login` graph is therefore isolated supply-chain liability, not hidden
|
||||
runtime-library anatomy.
|
||||
|
||||
The target boundary is the independent daemon mapped in
|
||||
`notes/standalone-codex-transport-migration.md`. One credential-isolated
|
||||
Yggdrasil connector already serves Ghostlight over encrypted CultNet, proving
|
||||
the process seam, but its current single-caller, single-key, fixed-model,
|
||||
stateless, no-tools contract and Ghostlight-owned deployment are not shared
|
||||
authority. The v2 daemon independently derives and verifies the exact provider
|
||||
request, returns a digest-bound transport receipt and typed events, and owns
|
||||
only Codex credential/transport physiology. Once both consumers pass that
|
||||
contract, Epiphany deletes its Codex spine, Codex-home/readiness plumbing, and
|
||||
every compiled Codex dependency; Ghostlight deletes its copied wire law and
|
||||
connector deployment path.
|
||||
|
||||
## Canonical authority map
|
||||
|
||||
| Owner | Inputs | Outputs | Invariant |
|
||||
|
|
|
|||
|
|
@ -243,6 +243,18 @@ behavior, not as cleanup chores. A narrower OpenAI auth/refresh boundary must
|
|||
preserve exact provider capability and refresh-token authority; a core split
|
||||
must expose an existing semantic owner rather than invent a package taxonomy.
|
||||
|
||||
The provider decision is now a service extraction, specified by
|
||||
`notes/standalone-codex-transport-migration.md`. Promote the already-proven
|
||||
Ghostlight connector seam into an independently source-owned and Idunn-managed
|
||||
Codex transport daemon. Its v2 contract must admit distinct callers, bind exact
|
||||
native/provider request digests, return typed tool calls and terminal transport
|
||||
receipts, and preserve one credential-refresh writer. Only after Epiphany and
|
||||
Ghostlight pass that contract may the old paths be deleted. The completed cut
|
||||
removes Epiphany's Codex spine and auth/readiness plumbing, Ghostlight's copied
|
||||
wire types and connector deployment authority, and the stale bridge branch as
|
||||
a production source. No dual daemon or refresh writer is an acceptable
|
||||
transition state.
|
||||
|
||||
Model Atlas has component proofs but no live inter-swarm collaboration run.
|
||||
Preserve its publication, trust, transport, projection, Soul verification, Self
|
||||
admission, wake, brake, and Eve path until Gate 1 exercises the complete crossing.
|
||||
|
|
|
|||
|
|
@ -3,8 +3,8 @@
|
|||
Updated: 2026-08-24
|
||||
Branch: `codex/epiphany-shakedown-live`
|
||||
Latest committed implementation cut: `a6cf9383`
|
||||
Current pass: Codex transport quarantined at release entrypoints; Ox17 and
|
||||
Atlas Gate 1 remain paused
|
||||
Current pass: standalone Codex transport authority mapped; source extraction
|
||||
is next; Ox17 and Atlas Gate 1 remain paused
|
||||
|
||||
## Orientation
|
||||
|
||||
|
|
@ -45,6 +45,21 @@ authorize the next capstone or Gate 1.
|
|||
|
||||
## What just landed
|
||||
|
||||
`notes/standalone-codex-transport-migration.md` is the authority and deletion
|
||||
map for removing Codex transport entirely from Epiphany's process/build body.
|
||||
Yggdrasil already proves the underlying process boundary through the
|
||||
Ghostlight-only `epiphany-model-connector.service`, but that connector is
|
||||
source-owned by stale branch `codex/epiphany-model-bridge`, deployed in
|
||||
Ghostlight's Idunn transaction, limited to one caller/key/model, stateless, and
|
||||
unable to return tool calls. The target is an independent Idunn-managed daemon
|
||||
with one writable Codex refresh store, distinct authenticated callers, exact
|
||||
native/provider request-digest receipts, typed tool-call pass-through, bounded
|
||||
replay/concurrency, and redacted CultMesh health. Consumers keep prompts,
|
||||
projection, tools, retries, interpretation, decisions, and admission. The hard
|
||||
deletion line removes Epiphany's Codex spine/dependency/auth-readiness plumbing
|
||||
and Ghostlight's copied protocol/deployment ownership. No live service,
|
||||
credential, or deployment authority moved in this mapping pass.
|
||||
|
||||
Exact `a6cf9383` quarantines concrete Codex/OpenRouter authentication,
|
||||
credential reading, and network transport at the two release entrypoints that
|
||||
perform inference. `epiphany-openai-runtime` now owns only exact native-request
|
||||
|
|
|
|||
261
notes/standalone-codex-transport-migration.md
Normal file
261
notes/standalone-codex-transport-migration.md
Normal file
|
|
@ -0,0 +1,261 @@
|
|||
# Standalone Codex Transport Migration
|
||||
|
||||
## Objective
|
||||
|
||||
Move Codex subscription authentication and model transport into one independent
|
||||
GameCult daemon consumed by Epiphany and Ghostlight. The daemon exists to
|
||||
protect one credential-refresh writer, one upstream compatibility boundary,
|
||||
and one independently deployable failure domain. It owns no cognition.
|
||||
|
||||
The target is a typed service boundary, not a native in-process ABI. CultNet
|
||||
MessagePack over authenticated loopback transport is already proven on
|
||||
Yggdrasil and keeps callers independent of the daemon's language, build graph,
|
||||
and release cadence.
|
||||
|
||||
## Current mechanism
|
||||
|
||||
Two mechanisms currently overlap:
|
||||
|
||||
1. Epiphany compiles `epiphany-openai-codex-spine` into its model and Persona
|
||||
entrypoints. That crate imports vendored `codex-login` and `codex-client`.
|
||||
Epiphany therefore carries Codex credential paths, readiness checks, CLI
|
||||
arguments, HTTP transport, and the complete transitive Codex build graph.
|
||||
2. Yggdrasil already runs `epiphany-model-connector.service` for Ghostlight.
|
||||
It uses encrypted CultNet/MessagePack on loopback TCP 4103, owns a private
|
||||
writable Codex home, serializes refresh through one `AuthManager`, bounds
|
||||
payloads and parallelism, rejects replay/substitution, and advertises a
|
||||
redacted `model.generate.structured` capability through Odin.
|
||||
|
||||
The second path is source-owned by the stale
|
||||
`codex/epiphany-model-bridge` branch, admits only
|
||||
`ghostlight-dungeon-yggdrasil`, and is built/deployed inside Ghostlight's Idunn
|
||||
transaction. Ghostlight duplicates its wire documents locally. The live proof
|
||||
is useful; the ownership is not.
|
||||
|
||||
## Authority map
|
||||
|
||||
### Standalone Codex transport daemon
|
||||
|
||||
Owner:
|
||||
|
||||
- Codex-compatible credential loading and persistent refresh rotation;
|
||||
- required client identity and authorization/account headers;
|
||||
- exact upstream request transmission and provider response decoding;
|
||||
- per-caller authentication, admission, payload/concurrency limits, and
|
||||
transport replay protection;
|
||||
- typed transport receipts and redacted CultMesh/Odin capability/health.
|
||||
|
||||
Inputs:
|
||||
|
||||
- one authenticated caller identity;
|
||||
- one exact native request and its deterministically derived provider request;
|
||||
- provider/model admission requested by the caller;
|
||||
- an expiry bound and request identity.
|
||||
|
||||
Outputs:
|
||||
|
||||
- ordered typed model events;
|
||||
- one typed transport receipt binding caller, native-request digest,
|
||||
provider-request digest, provider/model, response identity, usage, and
|
||||
terminal transport outcome.
|
||||
|
||||
Derived state:
|
||||
|
||||
- current health, capacity, admitted provider/model capabilities, and caller
|
||||
pressure are CultMesh/Eve projections;
|
||||
- the bounded replay cache is transport physiology, not decision history;
|
||||
- request/provider documents returned in the receipt are evidence of bytes
|
||||
transported, not daemon-owned decisions.
|
||||
|
||||
Forbidden writers:
|
||||
|
||||
- the daemon cannot author prompts, reasoning projections, tool policy,
|
||||
decision contexts, structured outcomes, retries between agent passes, Mind
|
||||
mutations, Ghostlight world mutations, or caller scheduling;
|
||||
- the daemon cannot execute a returned model tool call;
|
||||
- no caller may read or write the daemon's Codex credential store;
|
||||
- no consumer deployment brake may gate daemon startup or same-release
|
||||
continuity.
|
||||
|
||||
### Epiphany
|
||||
|
||||
Epiphany owns its sealed reasoning basis, exact native request, deterministic
|
||||
provider lowering, tool loop, terminal context, typed result/failure, Mind
|
||||
admission, and commit receipt. It stores the exact provider request locally and
|
||||
accepts a daemon result only when the transport receipt binds its exact digest.
|
||||
The daemon is evidence-bearing Hands physiology for inference; it is not Mind,
|
||||
Self, Persona, or Modeling.
|
||||
|
||||
### Ghostlight
|
||||
|
||||
Ghostlight owns lived-stream projection, stage/model policy, schema, timeout,
|
||||
retry, interpretation, and atomic world mutation. It stores the daemon's exact
|
||||
transport receipt. It does not share a caller key, request namespace, quota, or
|
||||
decision state with Epiphany.
|
||||
|
||||
### Idunn
|
||||
|
||||
The daemon is an independent Idunn target with its own immutable package,
|
||||
deployment brake, lifecycle observation, rollback, and signed health. Neither
|
||||
the Ghostlight nor Epiphany transaction builds, selects, deploys, or rolls back
|
||||
the daemon. Consumer units may order softly after it or discover it through
|
||||
Odin; its absence makes model work unavailable without taking either local
|
||||
state owner down.
|
||||
|
||||
## Shared paths
|
||||
|
||||
Every Codex-backed request uses one path:
|
||||
|
||||
```text
|
||||
caller-owned projected state
|
||||
-> caller-owned exact native request
|
||||
-> pure deterministic provider lowering
|
||||
-> authenticated connector invocation
|
||||
-> daemon validates caller + exact request binding
|
||||
-> vendored Codex auth/client transport
|
||||
-> typed provider events + transport receipt
|
||||
-> caller validates receipt/digests
|
||||
-> caller-owned interpretation and admission
|
||||
```
|
||||
|
||||
Persona, repository workers, Ghostlight fast/capable stages, retry, re-entry,
|
||||
and tool-followup requests share this transport primitive. They retain their
|
||||
family-specific state and consequence owners.
|
||||
|
||||
## Protocol cut
|
||||
|
||||
The existing v1 connector proves the transport but is not the shared contract.
|
||||
The v2 hard cut must provide:
|
||||
|
||||
- distinct authenticated caller keys and keyed caller admission;
|
||||
- exact caller/runtime and request identity;
|
||||
- exact native-request and provider-request SHA-256 binding;
|
||||
- model/tool definitions, prior tool calls, and tool results;
|
||||
- ordered typed text, tool-call, completion, and failure events;
|
||||
- one terminal transport receipt with provider response and usage identity;
|
||||
- byte-identical replay for the same caller/request/digest and refusal for a
|
||||
conflicting replay;
|
||||
- bounded per-caller concurrency and total payload/output limits;
|
||||
- no reasoning-delta publication or transcript-retention dependency;
|
||||
- provider/model capability discovery without credentials or prompt data;
|
||||
- explicit refusal documents rather than connection-close ambiguity.
|
||||
|
||||
The caller derives the provider request using the shared pure dialect compiler.
|
||||
The daemon independently derives it from the native request and refuses a
|
||||
digest mismatch before network access. This retains one canonical native
|
||||
request while proving which exact provider request was transmitted.
|
||||
|
||||
## Deletion line
|
||||
|
||||
After both consumers pass v2 acceptance:
|
||||
|
||||
### Epiphany
|
||||
|
||||
- delete the `epiphany-openai-codex-spine` package;
|
||||
- delete all non-vendor compiled dependencies on `codex-login`, `codex-client`,
|
||||
and vendored Codex;
|
||||
- delete direct Codex auth/HTTP/SSE transport construction;
|
||||
- delete `--codex-home`, Codex-home creation, Codex credential readiness, and
|
||||
Codex credential systemd inputs from Epiphany runtime physiology;
|
||||
- move Codex header/auth/SSE verifier ownership into the daemon;
|
||||
- retain only provider-neutral native requests, pure provider lowering,
|
||||
OpenRouter's separately owned direct credential path, and the connector
|
||||
client.
|
||||
|
||||
### Ghostlight
|
||||
|
||||
- delete copied connector envelope/invocation/result/model DTO definitions;
|
||||
- delete its private connector crypto/framing implementation when the shared
|
||||
typed client owns that law;
|
||||
- delete connector build, package, selection, rollback, and witness handling
|
||||
from the Ghostlight Idunn transaction;
|
||||
- retain Ghostlight stage projection, model policy, timeout, receipt
|
||||
validation, and world admission.
|
||||
|
||||
### Infrastructure
|
||||
|
||||
- delete the Epiphany-branded connector service/source identity;
|
||||
- delete the single `--allowed-caller` and shared `gamecult-model` key model;
|
||||
- delete Ghostlight's ownership of connector deployment;
|
||||
- remove the old daemon only after the standalone daemon owns the sole writable
|
||||
refresh store and both consumers pass exact receipt checks.
|
||||
|
||||
No compatibility reader, dual daemon, dual refresh writer, provider-request
|
||||
fallback, or prompt-shaped HTTP shim survives cutover.
|
||||
|
||||
## Subtraction budget
|
||||
|
||||
The migration may add one repository, one Cargo package, one daemon binary,
|
||||
one typed protocol module, and one independent Idunn target. Those surfaces are
|
||||
earned by credential privilege, refresh serialization, independent lifecycle,
|
||||
and reuse by two live consumers.
|
||||
|
||||
They must replace:
|
||||
|
||||
- Epiphany's entire embedded Codex transport package and transitive build graph;
|
||||
- Epiphany's Codex credential/config/readiness plumbing;
|
||||
- Ghostlight's copied protocol/client definitions;
|
||||
- the stale connector branch as a production source;
|
||||
- the connector portion of Ghostlight's deployment transaction;
|
||||
- duplicated caller-specific keys or refresh stores.
|
||||
|
||||
The migration is a failure if maintained code, executable count, credential
|
||||
writers, or deployment authorities increase after the old paths are deleted.
|
||||
|
||||
## Build budget
|
||||
|
||||
Before cutover, no local workspace-wide build is authorized.
|
||||
|
||||
- The standalone daemon owns one release binary and its focused library tests.
|
||||
- Epiphany checks only its connector client, pure runtime library, model binary,
|
||||
Persona binary, and changed coordinator/readiness owners.
|
||||
- Ghostlight checks only the shared-client integration and consequential model
|
||||
stage/world-admission tests.
|
||||
- Idunn performs each repository's exact full release build on Yggdrasil.
|
||||
- Compiler output roots are measured and cleaned after each focused local pass.
|
||||
|
||||
The expected Epiphany delta is removal of every Codex crate from `cargo tree`
|
||||
for all Epiphany production targets. The current release-edge proof's 10.473
|
||||
GiB/16,483-file footprint is the pre-cut comparison.
|
||||
|
||||
## Migration order
|
||||
|
||||
1. Create the independent source owner from the proven connector behavior, not
|
||||
by merging the stale branch into Epiphany.
|
||||
2. Define and test the v2 typed contract, multi-caller isolation, exact request
|
||||
binding, tool-call pass-through, refusal, replay, and redacted status.
|
||||
3. Package the daemon as an independent Idunn target without changing the live
|
||||
refresh writer.
|
||||
4. Add Epiphany's v2 client and prove transcript-free decision audit plus tool
|
||||
continuation through a fake connector.
|
||||
5. Add Ghostlight's v2 client and remove its copied wire law.
|
||||
6. Stop the old connector, transfer its auth store once under root custody,
|
||||
start the standalone release, and prove one refresh writer.
|
||||
7. Cut consumers over independently and verify exact signed health/transport
|
||||
receipts.
|
||||
8. Delete embedded Epiphany Codex transport and Ghostlight-owned connector
|
||||
deployment in the same accepted release sequence.
|
||||
9. Delete the stale connector branch only after its useful Git history is
|
||||
referenced from the new repository.
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Epiphany and Ghostlight issue concurrent requests under distinct caller keys;
|
||||
neither can replay, decrypt, exhaust, or impersonate the other.
|
||||
- One process and one writable Codex auth store own refresh rotation.
|
||||
- Exact native/provider request substitution refuses before network access.
|
||||
- A connector receipt reconstructs the exact transport basis without a model
|
||||
transcript.
|
||||
- Epiphany tool calls return as typed intents and execute only through
|
||||
Epiphany's governed tool owner.
|
||||
- Ghostlight retains its exact stage/world admission semantics.
|
||||
- Daemon restart preserves auth and replay invariants without waking either
|
||||
consumer's cognition.
|
||||
- Either consumer may be absent or braked while the daemon and the other
|
||||
consumer remain healthy.
|
||||
- No Epiphany production target contains a Codex crate in its normal dependency
|
||||
graph.
|
||||
- Ghostlight no longer defines the connector protocol or deploys the daemon.
|
||||
- Idunn independently proves daemon source, package, runtime, and signed health.
|
||||
- Model Atlas remains untouched and operationally unaccepted throughout this
|
||||
migration.
|
||||
Reference in a new issue