Document packaged release API cut

notes/epiphany-current-algorithmic-map.md

@@ -790,6 +790,12 @@ its exact packaged release, brake, process owner, and resident provider through
 `resident_readiness`. Idunn's deployment health remains an external receipt,
 not an Epiphany-owned shadow store.
 
+Exact `1e4fa533` narrows packaged-release API to actual consumers. Authentication
+opens its typed witness directly; construction-private binary enumeration and
+witness I/O no longer masquerade as root APIs; validation remains visible only
+to the parent publication/authentication owner. Package, publish, inspect,
+authenticate, and exact digest operations remain the external contract.
+
 ## Canonical authority map
 
 | Owner | Inputs | Outputs | Invariant |

notes/epiphany-fork-implementation-plan.md

@@ -234,7 +234,9 @@ route/grant/Verification chain. Exact `fab6a59a` deletes the never-called Idunn
 runtime-health signer/aggregate/RUDP module. Exact `200732e9` deletes its
 equally isolated provider-health query/admission store. The release swarm still
 uses `resident_readiness`; Idunn's deployed health authority remains external.
-Narrow zero-consumer Core exports next.
+Exact `1e4fa533` then narrows packaged-release API to its real package,
+publish, inspect, authentication, and digest consumers. Continue the
+single-caller public-surface audit without touching paused Model Atlas.
 
 Preserve exact provider-request sealing, the lean Connector client ABI,
 OpenRouter's separate temporary release edge, keyed Mind audit/CAS guarantees,

notes/fresh-workspace-handoff.md

@@ -2,10 +2,10 @@
 
 Updated: 2026-08-25
 Branch: `codex/epiphany-shakedown-live`
-Latest committed Epiphany source cut: `200732e9`
+Latest committed Epiphany source cut: `1e4fa533`
 Current connector source: `6dc80f6d266db4d82566d2434adcc55a48e8ecad`
-Current pass: both never-called Idunn health simulacra are gone; narrow Core's
-remaining zero-consumer public exports next.
+Current pass: packaged-release exports now match real consumers; inline the
+single-caller canonical brake-surface helper next.
 Ox17 and Atlas Gate 1 remain paused
 
 ## Orientation
@@ -17,7 +17,7 @@ Idunn's Yggdrasil CI/CD task with local compiler work, or wake resident
 cognition without an explicit operator resumption.
 
 Epiphany is a supervised engineering alpha. Exact source `d2ca6630` remains the
-production symlink body and is inactive. Exact `200732e9` is the current
+production symlink body and is inactive. Exact `1e4fa533` is the current
 build-affecting source on this branch. Historical live proofs remain evidence;
 they do not authorize the next capstone or Gate 1.
 
@@ -47,6 +47,15 @@ they do not authorize the next capstone or Gate 1.
 
 ## What just landed
 
+Exact `1e4fa533` inlines the one-caller packaged-release loader into
+authentication, makes required-binary enumeration and witness read/write
+private to construction, and demotes validation/file/digest checks to the
+parent packaged-release owner. Five unconsumed root exports disappear while
+package/publish/inspect/authentication remain public. The cut removes seven
+maintained lines. Packaged-release 15/15 and the release entrypoint pass.
+Verification produced 1.45 GiB across 2,554 files; cleanup restored the exact
+authenticated state inspector.
+
 Exact `200732e9` deletes the 1,030-line `idunn_provider_health` module and
 eight Core export lines. Its query, candidate verification, monotonic admission
 store, typed admission family, and six self-tests had no production consumer.

state/map.yaml

@@ -115,7 +115,7 @@ current_status:
   summary: The keyed RepoModel hard cut, decision-context foundation, Model Atlas code slice, complete Body, Proposal, frontier-verdict Modeling, frontier Research, frontier Verification, frontier Planning/PlanMind, Reorientation, and Persona decision-context lifecycles are landed on codex/epiphany-shakedown-live. Keyed Mind plus exact runtime receipts own coordinator presence, work discovery, deterministic launch, job-bound continuation, review, typed failure, semantic admission, and retained decision reachability. Exact 07d891ba and ec1431ff delete the persisted/global thread aggregate and its generic coordinator/prompt/revision surfaces. Exact f7948795 deletes MindGatewayReview, MindStateCommitReceipt v0, the generic interpreter prompt, runtime registration/read APIs, false thought/state-effect/adoption CultNet mouths, and stale launch proof profiles. CultMesh now projects only reasoning basis, decision context, and exact Mind commit receipt, read-only. Exact 1c9aafd8 seals the terminal decision context before model-backed frontier-Planning failure and binds the typed failure to it. Exact e0e75a30 deletes the residual aggregate role patch/parser/policy surface, gives Research one closed typed decision, and deletes the unowned generic Imagination planning patch. Exact 12b1b285 makes runtime model/tool binding validation the shared owner for execution and decision sealing; hostile provider, receipt, and stored-binding substitutions refuse, while retained basis/context audit survives transcript-delta deletion. Exact 01602fd3 advances Mind/runtime to v2/v1 and refuses historical or split writable identity pairs before registered writers see them. Exact 26b6a5bf proves simultaneous disjoint Modeling writes, simultaneous Verification+Modeling admission, same-identity conflict, exact replay, and reopened graph assembly; raw mutation primitives are crate-private. Exact 7c2ebd81 moves Persona state-note admission from the legacy agent-memory aggregate into keyed Mind documents and proves a concrete Hands consequence can commit simultaneously. Exact 79c0e373 seals the assembled Persona input and observed source versions in Mind before inference. Exact d3300bba authenticates that input through its one exact Mind commit, refuses naked typed documents, re-enters without external observation or model inference, and proves current-work reconstruction is identical and read-only across Launch, Wait, completed, and post-Research boundaries. Exact edb5c3a3 deletes the launch, heartbeat, and terminal-result family identity mirrors: the sealed typed launch owns live pass identity and the archived attempt owns historical request identity. Exact cabdd6c3 separates immutable coordinator incarnation basis/terminality from minimal model-session admission and removes the remaining session prose, clocks, dead states, redundant options, and whole-store coordinator snapshot. Exact a46725a1 reduces runtime jobs to Queued/Completed/Failed admission latches and removes timestamp selection from Research. Exact 10a70afc derives job role/session ownership from sealed launches and model bindings, leaving the generic job as identity plus status. Exact 53e869c0 removes generic job-result evidence/artifact mirrors; exact 8eaa96c5 stops persisting generic result documents for structured worker decisions; exact 2c3335dc deletes the generic result family entirely and makes typed decisions, model receipts/failures, job status, and process claims own their respective terminal facts. Exact dbb00c2b retains the minimal live/archive session pair for explicit phase closure and retired-identity refusal while deleting display echoes and a wrapper. Exact 24023265 makes the sealed Verification projection the sole Hands receipt input and deletes the duplicate live reread path. Exact a01c6842 deletes the coordinator's same-function always-approved Hands review, derives consequence authority through route/intent/grant identities, and refuses ambiguous receipt sets instead of selecting by timestamp. No compatibility reader, bootstrap aggregate, schema migrator, or dual reader survives. The source-level Decision-Auditable Concurrent Mind migration is accepted; the fresh exact-package capstone remains open. The machine remains a supervised engineering alpha; Model Atlas operational Gate 1 stays paused.
   public_positioning: docs/positioning.md is the current public claim owner. Epiphany is the organizational layer above frontier AI workers; global coherence collapse is the primary failure; prompts are bounded projections of governed organizational state; humans retain purpose, judgment, authority, disagreement, exceptions, and acceptance. GameCult is the forge and longitudinal evidence program for a target federation of one locally owned Epiphany project organism per living project Body. Model Atlas carries typed offers, claims, evidence, and derived technical relationships; Bifrost is the intended external work, membership, governance, attribution, and identity-linked receipt rail. Public Persona relationships and visitor surfaces are intended social infrastructure, while private Mind and consequence authority remain local. The fleet, real three-repository Gate 1, complete Bifrost attribution, sustained autonomous production, visitor experience, and external design-partner pilots remain gated alpha targets.
   competitive_launch_signal: The 2026-08-22 Munder Difflin launch analysis in notes/munder-difflin-launch-intelligence-2026-08-23.md is the current Eyes/Imagination owner for this category signal. It establishes strong demand to try a packaged, local, visual multi-agent control plane and supplies repeated qualitative demand for an operator-attention surface over plans, questions, blockers, decisions, consequences, and liveness; it does not establish retention, reliable autonomy, or paid product-market fit. Munder is materially ahead in installation, cross-platform reach, provider reuse, category compression, community formation, and feedback velocity. Its public failures make renderer-owned physiology, cross-Body restoration, proxy safety metrics, false consequence receipts, provider parity, and marketed-but-unavailable federation concrete falsification targets. Epiphany does not yet own a general operator UI: Persona projection into shared asynchronous chat is the concrete human surface, while CultMesh remains projection-neutral. Social Aquarium, a dense operator cockpit, TUI, and audit surfaces may use distinct Eve compositions over the same provider-owned facts. A one-hour projection experiment and managed continuity/federation remain evidence-led options rather than adopted roadmap authority; the source-subtraction and test-authority audit remains next.
-  latest_phase: Fresh-package Ox17 and Model Atlas Gate 1 remain paused while source subtraction continues. Exact a721b763 leaves one canonical native model request/event/receipt family, one model-adapter package owning native contracts plus pure provider lowering, a direct temporary OpenRouter release edge, and a lean authenticated CodexConnector client ABI. The independent CodexConnector daemon owns Codex caller admission, credential custody, provider transport, replay, and transport receipts; Yggdrasil runs it as its own service and Idunn target for Ghostlight, while a live Epiphany caller remains unaccepted. Keyed typed Mind, sealed reasoning bases and decision contexts, exact strong-read batch CAS, state-driven work, direct Body-to-Modeling flow, family-owned admission, Persona state, Hands consequences, Verification audits, and decision-preserving archival remain authoritative. Runtime events, role lanes, timestamps, global revisions, aggregate RepoModel authority, provider-event mirrors, embedded Codex transport, and the one-file OpenAI adapter package own no behavior. The optional epiphany-openai-runtime package remains earned because it isolates model and Persona orchestration from seven unrelated root release binaries. Exact 8086d66f folds single-consumer release construction beneath Core's packaged-release owner and deletes its package target. Exact 1e66e770 deletes the producerless Hands receipt constructors while retaining real consequence admission. Exact fab6a59a deletes the never-called Idunn runtime-health signer/aggregate/RUDP module. Exact 200732e9 deletes the adjacent producerless Idunn provider-health store. Continue by narrowing zero-consumer Core exports.
+  latest_phase: Fresh-package Ox17 and Model Atlas Gate 1 remain paused while source subtraction continues. Exact a721b763 leaves one canonical native model request/event/receipt family, one model-adapter package owning native contracts plus pure provider lowering, a direct temporary OpenRouter release edge, and a lean authenticated CodexConnector client ABI. The independent CodexConnector daemon owns Codex caller admission, credential custody, provider transport, replay, and transport receipts; Yggdrasil runs it as its own service and Idunn target for Ghostlight, while a live Epiphany caller remains unaccepted. Keyed typed Mind, sealed reasoning bases and decision contexts, exact strong-read batch CAS, state-driven work, direct Body-to-Modeling flow, family-owned admission, Persona state, Hands consequences, Verification audits, and decision-preserving archival remain authoritative. Runtime events, role lanes, timestamps, global revisions, aggregate RepoModel authority, provider-event mirrors, embedded Codex transport, and the one-file OpenAI adapter package own no behavior. The optional epiphany-openai-runtime package remains earned because it isolates model and Persona orchestration from seven unrelated root release binaries. Exact 8086d66f folds single-consumer release construction beneath Core's packaged-release owner and deletes its package target. Exact 1e66e770 deletes the producerless Hands receipt constructors while retaining real consequence admission. Exact fab6a59a deletes the never-called Idunn runtime-health signer/aggregate/RUDP module. Exact 200732e9 deletes the adjacent producerless Idunn provider-health store. Exact 1e4fa533 narrows packaged-release exports to real consumers. Continue by inlining the single-caller canonical brake-surface helper.
   execution_binding_authority_cut: Exact ce6bff12 reduces model and tool execution bindings to the only facts they own. A model binding maps one native request to its runtime session and job; a tool binding maps one typed intent to its runtime session and job. Provider identity, source worker, reasoning basis, and model-request ancestry are no longer copied into bindings or compared through timestamp-shaped API arguments. Validation, retention, public-source lookup, worker terminality, decision sealing, and tool continuation reload the exact native request or tool intent. Runtime writable state advances to v37. Core, epoch refusal, transcript-free decision audit, OpenAI tool continuation, and the release-owned tool runtime pass. The cut removes 67 net source lines and leaves runtime_spine.rs at 9,300 physical lines with 50 public functions and 25 public structs. Verification generated 12.713 GiB across 19,134 files; Cargo cleanup restored the single 1.78 MiB state inspector. Atlas is untouched; no live inter-swarm collaboration has run.
   provider_transport_boundary_cut: Exact ed7357a2 removes Codex transport from Epiphany's compiled body. The complete epiphany-openai-codex-spine package, codex-login/codex-client graph, CODEX_HOME/auth.json readiness, direct Codex HTTP/SSE, and Codex credential creation/argv are gone. Model and Persona entrypoints use the lean typed client from exact CodexConnector 54d8bc2525b7e7fa1b9dd26b95871247ff4c7566 over authenticated loopback MessagePack; Connector owns Codex auth, transport, replay, and exact native/provider digest receipts. Epiphany retains sealed native/provider requests, strict schema/call-ID projection, tool continuation, decision admission, and typed receipt evidence. OpenRouter remains one direct ureq/Rustls boundary with its own credential and terminal-tool dialect. Model receipts advance to v1 and runtime to v38; caller identity, both request digests, and cached-token usage survive transcript deletion. The maintained non-lock source shrinks by 857 lines and Cargo.lock drops 4,830 lines. Core 150/150, runtime 21/21, adapter 5/5, model edge 12/12, Persona 1/1, exact launch checks, and focused no-deps Clippy pass. Two focused build roots totaling 10.8 GiB were removed; only the exact 1,776,640-byte state inspector at SHA-256 DD38855C6F092C2C53D2212A938E737643F41130F4681708840BA6075320A04E remains. Atlas is untouched and no collaboration acceptance is claimed.
   provider_request_authority_cut: Exact c37cae8b replaces the durable generic OpenAI-shaped request with a closed provider-request document. The consumer adapter now lowers the canonical native request directly to either the exact final `CodexProviderRequest` or the exact OpenRouter request before inference and decision-context sealing. The release edge no longer performs Codex schema, tool, call-ID, or output-format lowering; it supplies the already sealed Codex request to the authenticated Connector invocation. Runtime and decision-context writable schemas advance to v47/v3 with no compatibility reader. Exact 87ea81db pins current Connector source 6dc80f6d266db4d82566d2434adcc55a48e8ecad and deletes Epiphany's obsolete 106-line public schema for the dead generic request, leaving two earned portable CultNet contracts. Connector separates contract-only, client, and daemon compile surfaces; Epiphany uses the contract-only surface in the adapter and the client surface only at the release edge. The Epiphany source cuts remove 125 net maintained lines; Core 152/152, runtime 21/21, adapter 5/5, model edge 12/12, Persona 1/1, and Connector contract/client/daemon 8/8, 10/10, 29/29 pass. Atlas is untouched and no live collaboration acceptance is claimed.
@@ -226,7 +226,7 @@ current_status:
     resident_physiology: historical_c011_exact_465af24d_zero_zombie_proof_accepted_current_containers_exited_255
   vendored_codex_eviction: Exact 7a125d78 deletes all 3,592 tracked vendored Codex files and 851,099 lines after Cargo metadata and manifest/source guards prove no build consumer. The seven dirty files contained only rustfmt and blank-line churn, so no semantic work was discarded or preserved as a counterfeit artifact. The root workspace exclusion, obsolete AGENTS search recipes, vendor-specific license clauses, and two superseded live migration notes are gone. The independent Connector contract remains the sole Codex-facing compile dependency. Gamecult-ops exact cb63e77 corrects the Yggdrasil inventory from the extinct Epiphany-branded/Ghostlight-owned daemon to the independent `yggdrasil-codex-connector` Idunn target. Historical archive notes and the explicitly dated June Body whitepaper remain inert history. No compilation or deployment mutation was required.
   unresolved_authority: `runtime_spine.rs` remains the largest central liability; it still mixes immutable identity, minimal model sessions/jobs, process claims, model/tool execution binding, family admission, consequence receipts, retention, and resurrection fences. Exact a01c6842 removes the counterfeit Hands review; route, Substrate Gate grant, minimal intent, frontier authority, and exact consequences now own that chain. No production actuator authors those receipts, so the coordinator truthfully stops at `awaitingHandsExecutor`. Exact c37cae8b closes the two-stage Codex request seam, exact 7a125d78 removes the excluded implementation corpse, exact 7374be5e removes split-snapshot current-work projection, exact 5f1bea39 removes the second fulfillment/replay store snapshot, and exact 2bcbf268 makes current work the sole coordinator scheduling projection. Ghostlight exact 8e7d980 pins the same Connector source contract. Historical c011 and partial Gate roots stay untouched/read-only.
-  next_action: Continue source subtraction from exact 200732e9. Narrow Core's exported surface where functions have no external consumer. Start with `canonical_epiphany_swarm_brake_protected_surfaces`, `load_epiphany_packaged_release`, `required_packaged_release_binaries`, and the packaged-release witness read/write helpers: prove each is used only by its owning module, make it private, and remove its root reexport. Do not delete the live brake, release package/publish/inspect commands, witness verification, resident readiness, or Model Atlas. Avoid workspace-wide builds or deployment mutation.
+  next_action: Continue source subtraction from exact 1e4fa533. Inline the single-caller `canonical_epiphany_swarm_brake_protected_surfaces` helper into the default brake and remove its root reexport, preserving the actual brake document and engage/release/read/write owners. Then continue the zero-consumer public-API audit one owning module at a time; do not touch paused Model Atlas merely because its operational consumer has not run Gate 1. Avoid workspace-wide builds or deployment mutation.
   single_snapshot_current_work_cut: Exact 7374be5e makes one pulled CultCache snapshot the sole input to Mind assembly, keyed RepoModel assembly, current-work Research and Planning lifecycles, Hands readiness, Modeling launches, reasoning-basis assembly, and Reorientation request projection. Three path-based wrappers and numerous repeated open/pull sequences are gone; Research and Verification admission also reuse their already authenticated cache for review and public-source consequence checks. The public Codex Connector client remains the earned ABI stub: deleting it would duplicate authenticated encryption and framing in every consumer, while no daemon/auth/HTTP/SSE implementation compiles into Epiphany. The cut is one net maintained line smaller, adds no schema, dependency, target, or process, and passes Core check, current-work 3/3, reasoning-context 8/8, Reorientation 1/1, Mind determinism 1/1, and RepoModel determinism 1/1. The focused run produced 2.0 GiB across 2,867 files; cleanup restored exactly the 1,776,640-byte inspector at SHA-256 DD38855C6F092C2C53D2212A938E737643F41130F4681708840BA6075320A04E.
   single_snapshot_fulfillment_cut: Exact 5f1bea39 makes typed fulfillment replay consume the caller's already pulled runtime Mind snapshot. Research, Verification, Proposal Modeling, PlanMind continuation, fulfilled-worker archival, and Resident Self completion no longer reopen the same `.cc` file while validating one immutable result. The generic path-based fulfillment wrapper is deleted. The public provider-runtime role-result function remains the sole path-based CAS writer; cache-local fulfillment can only replay the exact result already present in its supplied snapshot. The cut adds 17 maintained lines net to remove repeated physical reads while adding no schema, dependency, target, process, or decision authority. Core check, current-work 3/3, reasoning-context 8/8, structured-failure refusal, and the release-owned swarm entrypoint pass. Verification produced 2.2 GiB across 3,189 files; cleanup restored the exact authenticated state inspector.
   single_projection_coordinator_cut: Exact 2bcbf268 makes the current-work projection the sole scheduling input for operator status and Resident Self. An accepted reorientation decision's real manual-regather obligation is projected once with Body, Research, Planning, Modeling, Verification, Imagination, and Hands work. Status no longer opens and assembles Mind separately, and Resident Self no longer hard-codes a contradictory Continue value. `EpiphanyCrrcAction`, its five impossible transition variants, the parallel coordinator-input field, and the second Mind read are gone. The existing reorientation lifecycle now proves the durable regather decision reaches the user-visible coordinator action. The cut removes 12 maintained lines net, adds no persisted schema, dependency, target, or process, and passes Core check, current-work 3/3, Reorientation 1/1, operator-sanitization 1/1, and the release-owned coordinator compile. Verification produced 1.6 GiB across 2,924 files; cleanup restored the exact authenticated state inspector.
@@ -239,6 +239,7 @@ current_status:
   hands_constructor_cut: Exact 1e66e770 deletes the three public Hands receipt convenience constructors and their `too_many_arguments` exemption. Their only caller was the current-work lifecycle test, which now uses explicit typed receipt literals. The three receipt writers remain because they are the real consequence-admission owner: they validate route, intent, Substrate Gate grant, patch, successful command, commit, and exact Verification obligation under CAS. The cut removes 59 maintained lines with no schema or behavior change. The complete keyed Modeling/Research/Hands/Verification lifecycle and concurrent Persona/Hands proof passes. Verification produced 1.25 GiB across 1,888 files; cleanup restored the exact authenticated inspector.
   dead_idunn_runtime_health_cut: Exact fab6a59a deletes the 505-line `idunn_runtime_health` module and seven Core export lines. Its signer, aggregate calculator, RUDP publisher, two public shapes, and five self-tests had zero production caller. Idunn's deployed signed-health authority is external; Epiphany resident startup uses `resident_readiness`, and the separate provider-health admission module remained untouched in this cut. The deletion removes 512 maintained lines. Provider-health admission 6/6 and resident-readiness 11/11 pass. Verification produced 1.25 GiB across 1,888 files; cleanup restored the exact authenticated inspector.
   dead_idunn_provider_health_cut: Exact 200732e9 deletes the 1,030-line `idunn_provider_health` module and eight Core export lines. Its query, candidate verification, monotonic admission store, typed admission family, and six self-tests had no production consumer. The release-owned swarm compiles without it and the actual `resident_readiness` owner still passes 11/11. Idunn's external deployment-health authority is unchanged. The cut removes 1,038 maintained lines. Verification produced 1.45 GiB across 2,554 files; cleanup restored the exact authenticated inspector.
+  packaged_release_api_cut: Exact 1e4fa533 inlines the one-caller packaged-release loader into authentication, makes required-binary enumeration and witness read/write private to construction, and demotes validation/file verification/digest validation to the parent packaged-release owner. Five unconsumed root exports disappear. The release package, publish, inspect, authentication, exact witness digest, and all typed contracts remain public. The cut removes seven maintained lines and narrows six false API promises. Packaged-release 15/15 and the release entrypoint pass. Verification produced 1.45 GiB across 2,554 files; cleanup restored the exact authenticated inspector.
 
   runtime_spine_surface_cut: `runtime_spine.rs` owns immutable runtime identity, minimal model sessions/jobs and process claims, model/tool execution bindings, family admission, consequence receipts, retention, and identity-resurrection fences. Provider requests remain exact durable audit input; provider events/receipts normalize into one native persisted stream/receipt family. The sealed typed worker launch owns live pass-family identity and outer-worker role. Model execution bindings own model-session membership; outer-worker root membership is structural. Archived worker attempts retain exact request kind/ID, deletion digest, decision context, and full typed structured outcome after live launch deletion, including typed failures. Model sessions carry only grouping identity plus the active/completed phase latch; completed-session retention derives its exact jobs from model bindings and writes one private tombstone containing retired identities plus the deletion-chain digest. The live and archived documents protect distinct admission and resurrection invariants and do not duplicate decision cargo. Runtime jobs carry only job identity plus the Queued/Completed/Failed latch. No job clock, role/session mirror, intermediate status, generic terminal-result document, latest-result selector, or model-turn identity echo participates in causality. Typed role/reorientation outcomes own structured terminal decisions and atomically close their job/process physiology; native model receipt/failure records own model-pass terminality; process claims own process death. Verification reasons from the exact route, authority, intent, patch, command, and commit bodies sealed in its basis and has no review document or live receipt-reread tool. Mind/runtime writable epochs remain v11/v47; archived worker attempts are v3. Family launch CAS, model execution, and coordinator basis admission are the only session/job creation owners. Continue subtraction through the remaining single-caller runtime-spine surfaces; do not recreate deleted authority through registries, adapters, compatibility readers, or summary DTOs.