From ce22c3b11fea25414bb31d8498c48e925f65aa86 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Mon, 24 Aug 2026 16:47:24 +0200 Subject: [PATCH] Record durable Codex connector boundary --- notes/epiphany-current-algorithmic-map.md | 31 +++++---- notes/epiphany-fork-implementation-plan.md | 28 ++++---- notes/fresh-workspace-handoff.md | 44 ++++++++----- notes/standalone-codex-transport-migration.md | 61 +++++++++++++----- state/ledgers.msgpack | Bin 719087 -> 719747 bytes state/map.yaml | 4 +- 6 files changed, 110 insertions(+), 58 deletions(-) diff --git a/notes/epiphany-current-algorithmic-map.md b/notes/epiphany-current-algorithmic-map.md index 5902c629..fc87856c 100644 --- a/notes/epiphany-current-algorithmic-map.md +++ b/notes/epiphany-current-algorithmic-map.md @@ -659,17 +659,24 @@ route, not a tool route plus a parallel no-tools opinion. The remaining broad 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. Each consumer internally derives its exact typed provider request; -the v2 daemon verifies those exact bytes and returns a digest-bound transport -receipt plus typed events. It 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. +`notes/standalone-codex-transport-migration.md`. Independent +`GameCult/CodexConnector` exact +`9da6070faa1c4a29455b2383abfaae44d9a7b229` now owns one typed multi-caller +transport package and one public daemon binary without linking a Codex crate. +Each consumer internally derives its exact typed provider request. The daemon +verifies those exact bytes, returns a digest-bound transport receipt plus typed +events, and uses a private digest-pinned official `codex app-server` child only +to own credential refresh. The child never receives cognitive input or output. + +Replay is one keyed CultCache document per caller/request identity in an owned +Redb store. `Active` is durable before provider I/O; the exact encrypted +`Completed` response is durable before socket reply. After restart, completed +work replays byte-identically and ambiguous active work refuses without +consuming unrelated live capacity. RAM retains only the current process's live +execution set. Redacted CultMesh/Odin readiness remains open before the shared +consumer cuts. 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 @@ -682,7 +689,7 @@ connector deployment path. | `current_work.rs` | keyed Mind view and exact runtime request/job/result/decision families | pure family scheduling and continuation projections | Events, timestamps, role lanes, and thread provenance cannot create or suppress work. | | coordinator policy/status | keyed Mind presence, exact current work, and the accepted continuity decision | one action/reason pair plus operator-readable role lanes | Coordinator presence is derived; no mutable coordinator head, pressure tableau, or duplicate policy wrapper exists. | | runtime worker attempt owner | immutable launch, exact process claim, typed result, job result, archival evidence | one terminal attempt authority | Scheduling, process liveness, and semantic admission remain distinct authorities. | -| model-provider boundary | sealed native model request plus explicit provider configuration and injected credential | exact internally derived provider request and transport result | The pure runtime owns request/event admission; only release entrypoints own auth/network transport. Provider selection cannot author a second request truth or admit Mind state. | +| model-provider boundary | sealed native model request plus explicit provider configuration | exact internally derived provider request and transport result | OpenRouter remains a release-owned direct boundary. Codex transport is moving to independent CodexConnector, which owns only caller admission, credential refresh, exact transport, and durable replay. Provider selection cannot author a second request truth or admit Mind state. | | OpenAI Responses schema projector | full native typed output schema | one provider-legal strict generation schema | Provider formatting preserves useful supported constraints but never replaces native decoding or Mind admission. | | model-pass terminal owner | sealed reasoning basis/context and typed failure class | exact transport closure plus `EpiphanyModelPassFailure` and terminal session/job result in one batch CAS | The caller cannot nominate a job/session; the context-derived binding closes role, reorient, and Persona failures without granting generic transport results decision authority. | | Substrate Gate | exact worker/job authority and requested operation | scoped grant or refusal | Access permission does not admit Mind state. | diff --git a/notes/epiphany-fork-implementation-plan.md b/notes/epiphany-fork-implementation-plan.md index cf63d6f3..13c7d41b 100644 --- a/notes/epiphany-fork-implementation-plan.md +++ b/notes/epiphany-fork-implementation-plan.md @@ -243,18 +243,22 @@ 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 the -consumer's native-request digest to the exact daemon-verified provider-request -bytes, 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. +The provider decision is a service extraction specified by +`notes/standalone-codex-transport-migration.md`. Independent +`GameCult/CodexConnector` exact +`9da6070faa1c4a29455b2383abfaae44d9a7b229` owns the v2 multi-caller contract, +exact native/provider digest binding, typed tool and terminal receipts, the +pinned official Codex credential child, raw Responses transport, and durable +keyed replay. It links no Codex crate. Active replay identity is written before +network access; the exact encrypted completion is durable before reply; +restart ambiguity refuses rather than re-executing. Redacted CultMesh/Odin +readiness is the remaining daemon source cut before consumer work. + +Then Epiphany and Ghostlight must pass their shared-client contracts before the +old paths are deleted. The completed migration 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 diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index abc015d9..a8dcd326 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -2,9 +2,10 @@ Updated: 2026-08-24 Branch: `codex/epiphany-shakedown-live` -Latest committed implementation cut: `a6cf9383` -Current pass: standalone Codex transport authority mapped; source extraction -is next; Ox17 and Atlas Gate 1 remain paused +Latest committed Epiphany boundary document: `1ff87ab3` +Current connector source: `9da6070faa1c4a29455b2383abfaae44d9a7b229` +Current pass: durable standalone Codex transport core landed; redacted +CultMesh/Odin readiness is next; Ox17 and Atlas Gate 1 remain paused ## Orientation @@ -47,19 +48,30 @@ authorize the next capstone or Gate 1. `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, -consumer-native plus daemon-verified 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. +Independent repository `GameCult/CodexConnector` now owns one Cargo package +with one public daemon binary and no linked Codex crates. Exact +`9da6070faa1c4a29455b2383abfaae44d9a7b229` admits distinct authenticated +callers, preserves caller-native and exact provider-request digests, passes +typed text/tool/usage/failure results, and uses a digest-pinned official +`codex app-server` child only as the private credential writer. The connector +performs Responses HTTP/SSE transport itself; the child never sees prompts, +tools, model output, or consumer identity. + +Replay authority is now keyed CultCache over an owned Redb store rather than a +volatile map or whole-file rewrite. The daemon seals `Active` before provider +I/O and replaces it with the exact encrypted `Completed` response before +socket reply. Completed retries survive restart byte-for-byte; a restart-era +active identity returns explicit `Indeterminate` and never re-executes. A +non-secret connection-key epoch detects rotation without persisting a +secret-derived verifier. Focused native acceptance passes 22/22 plus exact +library/binary checks and Clippy. The disposable target peaked at 625 MiB and +was removed completely. + +Redacted CultMesh/Odin publication, Epiphany and Ghostlight shared-client cuts, +the independent Idunn target, and deletion of the old embedded/copied paths +remain open. Consumers keep prompts, projections, tools, retries, +interpretation, decisions, and admission. No live service, credential, or +deployment authority has moved. Exact `a6cf9383` quarantines concrete Codex/OpenRouter authentication, credential reading, and network transport at the two release entrypoints that diff --git a/notes/standalone-codex-transport-migration.md b/notes/standalone-codex-transport-migration.md index 33a035af..1d69039a 100644 --- a/notes/standalone-codex-transport-migration.md +++ b/notes/standalone-codex-transport-migration.md @@ -32,6 +32,30 @@ The second path is source-owned by the stale transaction. Ghostlight duplicates its wire documents locally. The live proof is useful; the ownership is not. +## Current cut status + +Independent `GameCult/CodexConnector` exact +`9da6070faa1c4a29455b2383abfaae44d9a7b229` completes migration steps 1-3 +except redacted CultMesh/Odin publication. It owns one Cargo package, one +public daemon binary, the v2 multi-caller encrypted MessagePack contract, +caller-native and exact provider-request digest binding, typed tool/result +transport, a private digest-pinned official `codex app-server` credential +child, raw Responses HTTP/SSE, and durable keyed replay. It links no Codex +crate. + +Replay uses one CultCache document per caller/request identity in an owned Redb +store. The daemon persists `Active` before provider I/O and replaces it with +the exact encrypted `Completed` response before socket reply. Completed replay +survives restart byte-for-byte. A restart-era active record returns explicit +`Indeterminate` and never re-executes; it does not consume current-process +capacity for unrelated identities. Replay records do not disappear merely +because request admission expiry elapsed. A non-secret connection-key epoch +detects rotation without persisting a secret-derived verifier. + +Focused native acceptance passes 22/22 plus exact library/binary checks and +Clippy. The disposable target peaked at 625 MiB and was removed. No live +service, credential, consumer, or deployment authority has moved. + ## Authority map ### Standalone Codex transport service @@ -70,7 +94,8 @@ 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; +- keyed replay records are transport physiology, not decision history; they + remain durable until a separately proven retirement law exists; - request/provider documents returned in the receipt are evidence of bytes transported, not daemon-owned decisions. @@ -153,7 +178,8 @@ The v2 hard cut must provide: - 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 +- durable byte-identical replay for the same caller/request/digest, explicit + indeterminate refusal after a crash-era active claim, and refusal for a conflicting replay; - bounded per-caller concurrency and total payload/output limits; - no reasoning-delta publication or transcript-retention dependency; @@ -254,25 +280,28 @@ 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. Prove the pinned app-server handshake, single-writer credential refresh, - exact binary/home identity, and raw provider transport without linking any - Codex crate. -4. Package the service process tree as an independent Idunn target without +1. Landed: create the independent source owner from the proven connector + behavior without merging the stale branch into Epiphany. +2. Landed except redacted status: define and test the v2 typed contract, + multi-caller isolation, exact request binding, tool-call pass-through, + refusal, and durable replay. +3. Landed in focused source acceptance: prove the pinned app-server handshake, + single-writer credential refresh, exact binary/home identity, and raw + provider transport without linking any Codex crate. +4. Publish redacted CultMesh/Odin readiness without credential, account, + prompt, replay, or decision cargo. +5. Package the service process tree as an independent Idunn target without changing the live refresh writer. -5. Add Epiphany's v2 client and prove transcript-free decision audit plus tool +6. Add Epiphany's v2 client and prove transcript-free decision audit plus tool continuation through a fake connector. -6. Add Ghostlight's v2 client and remove its copied wire law. -7. Stop the old connector, transfer its auth store once under root custody, +7. Add Ghostlight's v2 client and remove its copied wire law. +8. Stop the old connector, transfer its auth store once under root custody, start the standalone release, and prove one refresh writer. -8. Cut consumers over independently and verify exact signed health/transport +9. Cut consumers over independently and verify exact signed health/transport receipts. -9. Delete embedded Epiphany Codex transport and Ghostlight-owned connector +10. Delete embedded Epiphany Codex transport and Ghostlight-owned connector deployment in the same accepted release sequence. -10. Delete the stale connector branch only after its useful Git history is +11. Delete the stale connector branch only after its useful Git history is referenced from the new repository. ## Acceptance diff --git a/state/ledgers.msgpack b/state/ledgers.msgpack index 08a53a277dd50977947473c708bcb26f65fdbd8a..b3f50700c8e4b6af19a1527df349f49fd2ec448e 100644 GIT binary patch delta 717 zcmXw1J#Q015XI&r5Q&0@4rwIH*x1=zKAcqGDg_`Rs#MJFj^oAa-OKJ?lB-;#;13Y- zH;^b05;cDZ(SSq)@9emE+Pj&(_ujm@pTD-Q{%n1I+<90W7W;?W>g30*&A;!yJnfuy zI_1@M_rrC!1GMLD;0|yXxCd+i_kjmrue+NkzaM@4riN;-KRoEG;_Wv0KK=W?@nq38 z<6z`+9K08uLnOImooQrvZ@534FmLOE)u`CrE!ED!4wooNQJ4|$mr9Lj&NE3ArE=Vm zsUw$8$a)H1XeNyq8rLq5Sx<%Dh$(SZhiIshNSfWkNgPBut0iT!MtrupIi%-0+jH6ZartA3!A5*2EPk>X8kGEK8i!fkZa9ru2^Fl z5U#?t!S@jf#gIAUg+RJU#N^RPqN8MzD(GpC*c((ad|T{eU=SKQ$2qZ>9&1`|t+fg# zm;rGno1i^#*3ZN|qgT*?i%HOsF~nL+mDy{A$f>O;HBjn3Rjy7qNjh5&O6(51(lZ!? xiLtX))f`dA`u5Z=y|gdL*i?nITr{FQh3gA$e}Q>`NeGA4{9GfShyZBS_z&$%{gD6w delta 75 zcmZqvuKoU__69LVULz|511nRrsACLV-_LATW-Mf6Ol+RY)IODo5r{!FGZ3=?F)I+W S0Wmuea{w{t_Nh!