Aetheria/native/aetherlight/PROVENANCE.md
soul d3a1caa01b aetherlight: golden session digests, clockwork commit-cost harness, provenance
fixtures/golden.digests pins every committed revision's state and commit digest
and the export digest for one scripted session: speech (Told), a display, a
routine placed and rolled by a thirty-minute tick, and a refused convene. The
round-trip test reopens the export and checks the next command gives equal
receipts on both worlds. clockwork_commit_cost is an ignored harness that
prints mean tick and speech submit times at 100, 400 and 1600 persons.
PROVENANCE.md records the id, journal and dependency changes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:40:09 +01:00

20 KiB

Aetherlight provenance

Aetherlight is a fork of the synchronous world kernel of Ghostlight.

  • Upstream: GameCult/Ghostlight, crates/ghostlight/
  • Commit: c43eb54962ed4a09cc737ecac73a16b0d7ce62b4 (origin/main)
  • Taken: 2026-11-19
  • Authority: cut aetherlight-fork-import r1 of campaign aetheria-release; rulings aetherlight-narrative-state-owner and dialogue-is-world-action.

Every file below was copied as a raw git blob (git show), never git archive. The blobs are LF, as upstream. A Windows checkout with core.autocrlf turns the .rs files and the two text fixtures into CRLF; rustc, the fixture readers (lines(), trim()) and the golden test absorb that, so no .gitattributes is kept (a first commit had one; its stated reason did not hold). The recorded-world fixture (removed in AL2a) was binary and no newline rule touched it. Line ranges are in the c43eb54 file.

Taken

c43eb54 path (under crates/ghostlight/) Here Range Edits
src/lib.rs src/lib.rs all E1-E5, E10-E12
src/action.rs src/action.rs all E11, E12
src/clock.rs src/clock.rs all none
src/journal.rs src/journal.rs all E12
src/grammar.rs src/grammar.rs all none
src/grammar/tests.rs src/grammar/tests.rs all E12
src/import_key_tests.rs src/import_key_tests.rs all E12
src/patch.rs src/patch.rs 1-6059 and 7906-9606 (dropped 6060-7905: the patch tool catalog, PATCH_TOOLS, patch_tools(), the field_example helpers, mod catalog_tests) E6, E7, E12
Cargo.lock Cargo.lock all pruned by cargo to the dependencies below

Cargo.toml is new: package aetherlight, its own [workspace], no features, dependencies rmp-serde, serde, serde_json, sha2, thiserror, unicode-normalization, unicode-properties, uuid (serde only); dev uuid with v4 (AL3a).

Edits

  • E1. lib.rs: dropped the mod lines and every pub/pub(crate) use of aetheria, consumer, controllers, elaboration, local_inference (with its cfg(feature = "test-support") re-export), mailbox, sdk_inference, table, tool_schema, vault, verse.

  • E2. lib.rs crate docs: retitled to Aetherlight with a pointer to this file; the compile_fail doc-tests name aetherlight:: instead of ghostlight::. The sealing prose is kept.

  • E3. lib.rs: #![allow(dead_code)]. The kernel has no entry point until AL4 adds the ABI; AL4 removes the attribute.

  • E4. lib.rs: imports that only dropped code used are removed (cover::{CellId, Constituent, Resolution}), or moved under #[cfg(test)] because only tests use them (patch::{Bounds, Declaration, EntityDeclaration, SubjectDeclaration}).

  • E5. lib.rs: let mut removed from the closures confine_subject and confine_place (unused-mut in the non-test build).

  • E6. patch.rs: deleted use super::tool_schema;, use codex_connector::CodexToolDefinition; and use serde_json::{Value, json}; (only the dropped catalog used the last one); let mut removed from the controller_id closure.

  • E7. patch.rs: lines 6060-7905 dropped as above.

  • E8. lens.rs: deleted test every_lead_names_a_patch_tool and its use crate::patch::PATCH_TOOLS;, which read the dropped catalog.

  • E9. lens.rs: the doc comment on leads_with says "patch tool names" instead of naming PATCH_TOOLS.

  • E10. lib.rs crate docs describe the fork as it is (no runner, no ports, no controllers); the compile_fail doc-tests keep no error code (stable rustdoc does not check one) and the two that named items absent from the fork (fixture_controller_opportunities, fixture_inference_output) are deleted. The VerifiedPrincipalEvidence doc no longer links WorldMailbox/SeedPort and says nothing here enforces valid_until; the ABI must (AL4).

  • E11. New tests, not upstream, each killing a mutant that survived upstream's 810 tests: action::tests::holding_exactly_the_threshold_satisfies_holds, clock_tests::committed_requires_the_named_counterparty, clock_tests::committed_requires_the_named_kind, soul_knowledge_tests::a_telling_by_a_speaker_outside_its_audience_does_not_apply.

  • E12. Cut AL2a deletes the model-guidance lanes; see the section below. It supersedes E4's cover import, E8 and E9 (lens.rs is gone), and lib.rs, patch.rs, journal.rs, action.rs, grammar/tests.rs and import_key_tests.rs lose the symbols and tests listed there.

The ghostlight.* schema ids were renamed in AL3a (see the last section). The golden replay AL2a removed is back as fixtures/golden.digests (AL3a).

Left behind

Upstream file Why it is not here
mailbox.rs the async port/mailbox lane around the kernel; AL4's ABI replaces it
controllers.rs model decider lane; composes an invocation's speech text, which Aetheria's player and C# brains do themselves
elaboration.rs model elaboration lane
consumer.rs consumer patch admission over HTTP-shaped ports; speech only in its fixtures
table.rs encodes actor calls as model tools
vault.rs evidence source over a vault
local_inference.rs, sdk_inference.rs model backends (tokio, reqwest, codex-connector)
tool_schema.rs tool schemas for model calls
aetheria.rs, aetheria/ Ghostlight's Aetheria catalog reader; Aetheria content is read by Aetheria
verse/ one example world; its speech affordances are a pattern to copy into Aetheria content, not a kernel dependency
tests/external_admission.rs the cross-crate proof that forged, serde-minted opportunities and ids are refused at the public surface; dropped with the consumer lane it drove. AL4 must carry an equivalent proof against the ABI's own surface
crates ghostlight-persona-projection, ghostlight-verse; sidecar/ outside the synchronous kernel

Speech as world action stays whole: affordance declarations with carries_speech, preconditions, audience, effect slots and outcome bands, Communicate and Display, Knowledge and Told, commitments (patch.rs); exercise, role binding, preconditions, audience, band selection and lowering (action.rs); DecisionInvocation, DecisionEvent and ResolvedOp::Communicate apply (lib.rs); the SpeakRenderPath check (grammar.rs).

Dependency pin

The crate no longer pins CultLib: cultcache-rs (Ghostlight's rev 85f7024a35ea42cf9f0a0199a064526427150191) left the manifest in AL3a with the redb store it served.

Pulling a later Ghostlight fix

By hand, against this file: read the upstream diff for the taken files, apply it here, and record it in this file with its upstream commit and the files it touched. A fix that lands in a left-behind file is not pulled.

Cut AL2a: the model-guidance lanes

Authority: cut aetherlight-cut-agency-a r1 of campaign aetheria-release; rulings aetherlight-narrative-state-owner and dialogue-is-world-action. Deleted, with their c43eb54 homes:

  • Lens (src/lens.rs, 361 lines): Lens, LensWeights; the genesis input, WorldState, snapshot and creation field lens_weights; CommandBody::SetLensWeights; WorldEffect::LensWeightsReplaced; Mismatch::LensWeightsNeverDraw; the draw-rule check in verify_state_shape.
  • Cover and agency graph (src/cover.rs, 1105 lines): Cover, Cell, CoverBudget, derive_cover, AgencyGraph; WorldKernel::agency_graph and fn agency_graph (lib.rs); CommandId::for_cell, for_cell_constituent.
  • Persona material (lib.rs, patch.rs): PersonaMaterial, PersonaReadRef, ComponentOp::SetPersonaMaterial and ResolvedOp::SetPersonaMaterial with resolution, apply and confinement arms, WorldState.persona_material, the subject snapshot's material, WorldPatch::sets_persona_of_existing_subject. The op set goes from 34 to 33.
  • Brief: the brief string in CreateWorld, CreateWorldIntent, WorldState, WorldEffect::WorldCreated, the snapshot and the shape checks.
  • Elaborator lane: SystemCapability::Elaborator, PatchAnswer, CausalBoundary, BoundaryDigest and derive_boundaries, exact_boundary, require_answer (the AnswerRequired gate), jurisdiction_deficit, ground_covers, place_in, PatchGround::Jurisdiction; WorldScaleIntent, WorldScaleIntentRef, JurisdictionKey, ScaleDeficitRow, qualifies, derive_scale_deficit, the subject snapshot's qualified, the snapshot's boundaries and scale_deficit, CreateWorld.scale_intent, CreateWorldIntent.targets and jurisdictions, CreateJurisdictionIntent, WorldState.scale_intent; CommandBody::AdmitPatch.answers and WorldEffect::PatchAdmitted.answers; KernelError::AnswerRequired, AnswerNotDerived, AnswerNotSatisfied; Mismatch::UnknownJurisdictionRoot and ScaleWeightsExceedWhole. resolve_patch loses its intent parameter.
  • The golden replay grammar::tests::existing_world_reopens_with_unchanged_digests and the recorded-world fixtures under tests/fixtures: removing state fields changed the state shape, so Ghostlight's recorded world no longer decodes. AL4 adds Aetherlight's own golden.

Behaviour with the gate gone: require_play_active keeps the one rule require_answer also held (Play authors nothing in Draft) and states the other as a plain rule: in Active, declaring (new structure or evidence) is Play's act alone, and the owner is refused. A confined author's only remaining check is confine_to_ground, which now serves the consumer ground alone.

AL4's ABI must route the host through typed commands (the sim reports events, scripts propose), never through owner declarations in Active: under aetherlight-narrative-state-owner an owner declaring in Active would be a second door beside that path.

Kept untouched for AL2b: controllers and ControllerMode, consumers (ConsumerId, SystemCapability::Consumer, PatchGround::Consumer, bound_to_consumer), the draft phase and approvals, VerifiedPrincipalEvidence. (Opportunities, scope digests, the attention order, ExerciseDecision and DeclineDecision went in AL2b-1, below.)

Leave-set vocabulary still compiled (AL2b's and AL4's triage list)

#![allow(dead_code)] still hides the dead code of a crate with no entry point. What the cut deletes is gone; what remains is part B's:

  • Authenticated-caller vocabulary: AuthenticatedCaller::fixture, verified_principal and verified_play; id helpers text and nil_for_test; commits_for_test; grammar verbs. AL4's ABI decides which of these it needs.
  • Patch ingress: decode_patch, check_patch_caps, PatchDecodeError and MAX_PATCH_BYTES, MAX_PATCH_DECLARATIONS, MAX_PATCH_OPERATIONS, MAX_PATCH_EVIDENCE; the consumer ingress and elaboration lane read them, and nothing here does. They stay: AL4's ABI decides whether it decodes patches itself.
  • Mailbox and vault comments (WorldMailbox, vault: evidence strings).

Reproduce the list with RUSTFLAGS=--force-warn dead_code cargo test --lib --no-run: under test configuration the items nothing exercises show up.

Cut AL2b-1: Play's Act replaces opportunity-based exercise

Base bf92a054f. An act is one command, Act { actor, invocation }, admitted for System(Play) in Active only, and one effect, Acted { invocation, event }. require_granted(state, actor, affordance) is the only constructor of GrantedAffordance: the actor's affordance_grants entry holds the affordance and the catalog defines it, otherwise AffordanceDenied. Retire removes a subject's grants, so a retired actor is refused by that check alone. action::exercise takes the actor in place of an opportunity; its pipeline is unchanged and the band draw keeps command_id as its only per-command term. DecisionEvent carries actor, not scope and controller_id. STATE_SCHEMA and COMMIT_SCHEMA moved to consumer.v8.

Deleted, with their bf92a054f locations in lib.rs:

  • ScopeDigest, ScopePreimage, DecisionOpportunity (459-506) and scope_digest, exact_opportunity, derive_opportunities, order_opportunities, pressure_total, attention_debt, granted_entries (3841-4034). WorldSnapshot.opportunities, WorldState.last_opportunity_at and the attention-stamp shape check in journal.rs (730-738).
  • CommandBody::ExerciseDecision and DeclineDecision, WorldEffect:: DecisionExercised and DecisionDeclined, their reduce and apply_effect arms, and KernelError::OpportunityMismatch, ScopeChanged, ControllerMismatch.
  • The operator log: operator_log, OperatorEvent, BoundRole (3518-3579, 1109-1134), and the kernel readers opportunities, clock_advances, controller_receipt, controller_decline_receipt.
  • WorldJournal::commits and FictionalMinutes::since, dead once the readers above went.

Kept: the whole dialogue lane (carries_speech, Communicate, Display, the kernel Speak entry, the grammar, preconditions_hold). DecisionScope stays the grant key and ControllerAssignment stays; the owner's AdmitPatch and AdvanceTime doors and SystemCapability::Clock stay.

AL2b-2a (below) took the writers; AL2b-2b still owns the controller half under aetherlight-play-only-after-genesis: ControllerAssignment (which until then holds only the Retired flag and unread identity data), NewController, ControllerId, ControllerMode, DecisionScope as the grant key, SubjectState.retired, Mismatch::UnadmittedController, the admits_human rename and the snapshot's controller fields.

last_acted_at and minted_at in snapshot still read state.events (by event.actor). AL3 needs keyed rows instead of a scan; that is the AL3 cut's.

Cut AL2b-2a: after genesis only Play writes

Base f51275c61. A world is born Active: the genesis commit is the owner's only act, and WorldState::empty has no phase and no approvals. After it CallerId::Play is the only caller any command body admits. CallerId is { Principal, Play }; Principal survives as the genesis creator (and as the refused caller of every post-genesis body). One rule, require_play, decides it at the top of reduce and again at the top of apply_effect, so it holds on commit and at replay; the journal gains no caller rule. require_ruler is forbid_rulings_at_genesis: genesis may not rule or mint, Play may. A grant row exists if and only if the subject holds a verb; a subject may be declared with none, and revoking the last verb removes the row. GrantsOutsideControl is GrantsToRetired. STATE_SCHEMA and COMMIT_SCHEMA moved to consumer.v9.

Deleted, with their f51275c61 locations in lib.rs unless noted:

  • The Clock and Consumer capabilities and CallerId::Controller: SystemCapability (388-406), AuthenticatedCaller::verified_controller (433), require_system_capability, require_clock_caller, require_play_active, require_owner and require_patch_author (1456-1514, 3594-3625, 3989-4006), and apply_effect's capability table.
  • The consumer lane: ConsumerId and its namespace (317-338), PatchGround (408-419), NewController::External, ControllerAssignment:: ExternallyControlled, expected_caller, consumer(), bound_to_consumer, candidate_places, confine_to_ground (3628-3792), operation_ground (3826-3987), and in patch.rs the mirror and human candidate sets, Mismatch::OutsideJurisdiction, RetiresAMirror, ControllerGrantMismatch.
  • The draft phase: WorldPhase, WorldState.phase and draft_approvals, CommandBody::ApproveDraft and ActivateWorld, WorldEffect::DraftApproved and WorldActivated, required_approvers, KernelError::WrongPhase, NotDraftApprover, DraftAlreadyApproved, MissingApprovals, the snapshot's phase, draft_approvals and required_approvers, Mismatch::RetiresAnApprover, and the Draft-only shape clause in journal.rs.
  • The never-mute rule and the controller/grant pairing: in admit_resolved, the resolver, Mismatch::WouldLeaveSubjectMute, and the shape clauses in verify_state_shape that required a grant row per controlled scope.
  • CommandId::derived, whose only caller was ConsumerId::of_name.
  • VerifiedPrincipalEvidence (106-146), CreateWorldIntent (366-376) and PrincipalCommandIntent (521-529). The valid_until enforcement that Ghostlight's mailbox did is no longer an AL4 obligation: the type that carried it is gone.

Kept: the whole dialogue lane, decode_patch, check_patch_caps, PatchDecodeError and the MAX_PATCH_* constants (AL4's ABI decides whether it decodes patches itself), the ghostlight.* schema namespaces (AL3 renames them), Retire, GrantAffordance and RevokeAffordance as Play's patch operations, and #![allow(dead_code)].

Nothing decides with a controller after this cut. ControllerAssignment, NewController::{Human, NarrativePersona, OperationalAgent}, ControllerId, ControllerMode, DecisionScope as the grant key, validate_assignment, Mismatch::UnadmittedController and admits_human (the genesis predicate three places read) stay compiled for AL2b-2b, which removes the controllers and renames the predicate.

last_acted_at and minted_at in snapshot still read state.events; the count of code readers of state.events did not rise (idea cutspecs-1119.al3-needs-keyed-rows).

Obligations this cut hands to AL4

  • A cross-crate proof that forged opportunities and ids are refused, equivalent to the dropped tests/external_admission.rs, against the ABI's surface.
  • Removal of #![allow(dead_code)].

AL2b-2b: controllers go, retirement on the subject

The subject controller is gone: ControllerAssignment, ControllerId, ControllerMode, NewController, DecisionScope, SubjectDeclaration.controller, Mismatch::UnadmittedController, validate_assignment, the snapshot's controller fields and ControllerId::issue. Retirement is SubjectState.retired, and is_retired is its only statement. affordance_grants is keyed by SubjectId. admits_human is is_genesis: it says what the from-nothing lane may build (the kernel Speak entry and the first subjects), not who may be bound. The schema is consumer.v10; v9 rows are refused at the schema gate, with no migration.

Not this cut's, and kept: the channel controller (ChannelRecord.controller, SetController, resolve_controller), which is dialogue (dialogue-is-world-action). An earlier version of this file listed resolve_controller and controller_key as AL2b-2b's; that was wrong.

Cut AL3a: the journal is in memory; ids are derived

Authority: cut aetherlight-journal-a r1 of campaign aetheria-release; rulings aetherlight-narrative-state-owner, cultnet-scale-is-not-negotiable, dialogue-is-world-action. Base 09a1c3256 (spec base 39c50acfc; no native/ change between them).

Ids. CommandEnvelope::id() is the first 16 bytes of sha256 over aetherlight.command.v1, the world id, the big-endian expected revision and the named messagepack of caller and body. CreateWorld::id() is the same over aetherlight.create.v1 and the whole creation. WorldId::of(creation id) is the same over aetherlight.world.v1; a genesis commit whose world id is not that is refused at open. The id fields on CreateWorld and CommandEnvelope, CommandId::new/parse_uuid and WorldId::issue are gone; CommandId::issue is a test fixture. Retry identity went with them: SubmitReceipt collapsed into CommitReceipt, and a resubmitted applied command is a RevisionMismatch. WorldCommit.committed_at is gone: wall time is the C# store's stored_at.

Journal. WorldJournal { commits } is the only record of a world. export() is canonical named messagepack of { schema: aetherlight.journal.v1, commits }; open(bytes) decodes canonically and replays through verify_history, which reads the revision-ordered slice and returns the head state it derives. There is no state row, no expected world id, no health or ownership check and no verify_append. STATE_SCHEMA and COMMIT_SCHEMA are aetherlight.world_state.v1 and aetherlight.world_commit.v1; any ghostlight.* schema is refused at the schema gate and at the commit chain.

Dependencies. chrono, cultcache-rs (and with it redb) and tempfile left the manifest; uuid keeps serde in [dependencies] and v4 only in [dev-dependencies], so no shipped path draws a random id (cargo build --lib compiles without it).

Not taken from the spec's text: the spec's negative pattern id: CommandId matches the command_id: CommandId parameters of the band draw and derivation (the per-command term the spec keeps); the doc comment said synchronous, which chrono matches, and now says single-threaded.