Record pass 9 in the ontology and mvp docs and handoff

Current mechanism describes the budgeted connected cover, the tick
driver as the single clock owner, and the grouped-cell membrane rule;
the scale section carries the ceil(N/R) bound, the two reasons the cap
yields, and the contention finding with its open operator decision; the
two stale claims about AdmitPatch phase and EvidenceRef are corrected;
the consumer-api drift note names the decided transport; controller
model variables are documented. Steward folded passes 1 through 9 and
the pass 10 design state.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Meta Vens 2026-09-05 03:24:11 +02:00
commit 1203aa3286
7 changed files with 167 additions and 85 deletions

View file

@ -108,7 +108,9 @@ The following are recalculated from committed state and may be discarded:
- subject-local projections;
- due-owner queues and attention plans;
- population covers and grouping choices;
- population covers, cells, cell ids, resolution, tick index, the agency
graph, and the cover budget (the only durable trace of a tick is the
controller-work row, custody-separate from world custody);
- action-owner counts and causal-capacity summaries;
- transcript, news, narration, and operator summaries;
- Eve/CultUI and CultMesh documents;
@ -287,7 +289,13 @@ choose a mode opportunistically. The scheduler does choose resolution: a
and is represented operationally, at coarse resolution, when grouped. That is
a budget decision, not a mode change; the controller, its scope, and its
authority are unchanged. A controller changes representation and model
ergonomics, never permission or commit authority.
ergonomics, never permission or commit authority. A `NarrativePersona` in a
grouped cell receives its typed view and nothing from the membrane; it mints
no `PersonaTurn`, so the immutable-turn-receipt rule does not apply to it.
The membrane is not weakened; it is not entered. The agency graph is
scheduler-only and is reachable from no prompt builder; its mailbox request
is port-narrowed (absent from the controller and elaboration ports), not
principal-authenticated.
An opportunity is issued to exactly one controller. An untranslated intent or
infrastructure fault cannot fall through to the other mode, and the same
@ -434,6 +442,17 @@ using unresolved pressure and time since the last opportunity, with subject id
as the final tiebreak. Causal exposure is derivable from `dependencies` and is
not an ordering input. It emits `DecisionOpportunity` values and cannot commit.
`drive_cover_tick` is the single owner of tick cadence, cover derivation, and
the clock: it derives the cover, runs the cells under a bounded concurrency
permit pool with a quarantine flag, and advances the clock after the cells so
every cell in a tick shares one `now` and one tick index. Its budget is
configuration (`GHOSTLIGHT_COVER_CELL_BUDGET`, `GHOSTLIGHT_COVER_CONSTITUENT_CAP`,
`GHOSTLIGHT_COVER_URGENCY_SLOTS`, `GHOSTLIGHT_CONTROLLER_MAX_CONCURRENT`,
`GHOSTLIGHT_TICK_INTERVAL_SECONDS`); changing any is a restart. The five
controller models are configuration too (`GHOSTLIGHT_CONTROLLER_PROJECTOR_MODEL`,
`_PERSONA_MODEL`, `_INTERPRETER_MODEL`, `_OPERATIONAL_MODEL`,
`_ELABORATOR_MODEL`), each with a default when absent.
The kernel commits one decision at a time through the mailbox. After each
commit the planner derives a fresh queue. Parallel inference may speculate on
one snapshot; a proposal binds to the scope digest of the components its

View file

@ -8,8 +8,11 @@ settle before a consumer patch can reach `AdmitPatch`: caller authority (which
`CallerId` a consumer lowers to), decode-time size bounds on the patch,
phase (Draft seed versus Active elaboration), and boundary answering (an
Active consumer patch that declares must answer a derived boundary like any
other author). The transport is an inbound `mesh.rs` path, not a fifth
`execute_world` operation literal.
other author). The transport is one typed inbound document over a second loopback route
beside `POST /cultnet/snapshot`, carrying the patch as a nested
canonical-msgpack byte frame bounded before any item deserializes; it is
not a fifth `execute_world` operation literal and not an organ of the
outbound mesh publisher.
## Objective

View file

@ -35,8 +35,9 @@ not from a model agreeing that the world is deep.
## Current mechanism
Passes 1 through 8 of the widening are landed (`5e53beb`, `e99af63`,
`d2805fe`, `0f21a49`, `dbe176d`, `cb6a126`, `1852ddd`, `3ed3868`). The sealed kernel holds subjects with a label and a
Passes 1 through 9 of the widening are landed (`5e53beb`, `e99af63`,
`d2805fe`, `0f21a49`, `dbe176d`, `cb6a126`, `1852ddd`, `3ed3868`,
`8aebfb6`). The sealed kernel holds subjects with a label and a
kind (`Person | Institution | Population`); a `positions` partition with
`Position`; entities with `container` under containment acyclicity; `Route`
as an `EdgeRecord` variant carrying `AccessKind { Public, Restricted }`, a
@ -61,10 +62,13 @@ outcome bands. The ten inhabited operations are `Relocate`, `OpenRoute`,
`Admit` (same-patch evidence), `Bind`, and `Release`; `apply_operations` is
the one owner of operation application and conservation, and
`patch::check_ledger` is the single named conservation check.
`CommandBody::AdmitPatch` is Draft-only and emits `WorldEffect::PatchAdmitted`
through the one `admit_resolved` insertion owner shared with genesis. No
production ingress authors a `WorldPatch` before pass 10; `EvidenceRef::new`
is `#[cfg(test)]`.
`CommandBody::AdmitPatch` emits `WorldEffect::PatchAdmitted` through the one
`admit_resolved` insertion owner shared with genesis; it has no phase gate of
its own, because in Active the answer rule below bounds what a patch may
declare. Before pass 10 the only production author of a `WorldPatch` is the
elaborator lane, which decodes items one at a time under its draft caps; the
kernel itself bounds a patch nowhere yet. `EvidenceRef::new` is `pub(super)`
and its production use is bounded by `filter_evidence`.
Character action is a precondition-effect transition. Grants are
`BTreeMap<DecisionScope, BTreeSet<AffordanceId>>`. `world/action.rs` owns
@ -161,6 +165,24 @@ and re-prompts with it, bounded by `ELABORATION_ROUND_BUDGET` and the
`EvidenceSource` receipts (`filter_evidence`); with `NullEvidenceSource` no
canonical fact and no `Admit` can land from the elaborator lane.
`world/cover.rs` owns the budgeted connected cover. `derive_cover(world, now,
tick, opportunities, agency_graph, budget)` is pure: it reads the attention
order that `order_opportunities` owns, reserves the urgency slots for its
head, rotates the remaining subjects through singleton cells by debt, and
packs the rest into grouped cells by connected component of the agency graph
(scheduler-only; reachable from no prompt builder). `Cell`, `Cover`,
`CellId`, `Resolution`, `TickIndex`, and `AgencyGraph` are derived and
disposable; the only durable trace of a tick is the `controller_work.v8` row
(`ControllerWork::Grouped`), custody-separate from world custody. A grouped
cell is one inference over partitioned per-constituent views returning zero
or one attributed proposal per constituent; declines are submitted first and
each proposal commits or is refused on its own scope digest; a coarse
`NarrativePersona` receives its typed view and does not enter the membrane.
Cell and constituent command ids are sha256-derived. The runtime's
`drive_cover_tick` is the single owner of tick cadence, cover derivation,
the bounded concurrency permit pool, the quarantine flag, and the clock,
which advances after the cells so every cell in a tick shares one `now`.
Opportunities bind to a `ScopeDigest` over one `scope_components` owner
(controller assignment, grants, delegated grants, own authority, position,
incident routes, own holdings, own dependencies, known fact ids, controlled
@ -168,9 +190,9 @@ channels, own commitments; never `now`, occupancy, forum state, or another
subject's knowledge); a proposal commits at any later revision with unchanged scope and is
rejected with `KernelError::ScopeChanged` otherwise. State schema is
`world_state.elaboration.v1`, commit schema `world_commit.elaboration.v1`,
controller work `controller_work.v7`; earlier stores are refused. Ghostlight owns a conserved narrative ledger;
controller work `controller_work.v8`; earlier stores are refused. Ghostlight owns a conserved narrative ledger;
Delvehold owns the economy (`delvehold-forced-ontology-integration.md`).
Pass 9 adds the budgeted cover; pass 10 adds the consumer ingress.
Pass 10 adds the consumer ingress.
## The failure this vocabulary is designed against
@ -559,10 +581,9 @@ none of which is a second identity layer:
quiet world moves without being looked at and without inventing spurious
crisis.
3. **Ordered attention.** The scheduler is a pure planner over one revision.
It orders opportunities by unresolved pressure, causal exposure,
readiness, and time since last opportunity, so every subject receives
direct attention within bounded ticks absent a mandatory foreground
override.
It orders opportunities by unresolved pressure, then time since last
opportunity, then subject id, so every subject receives direct attention
within bounded ticks absent a mandatory foreground override.
4. **Cell resolution.** A singleton cell is detail focus: a `NarrativePersona`
controller receives its prose membrane, an `OperationalAgent` its full
permissioned view. A grouped cell is one inference over its constituents'
@ -574,10 +595,34 @@ none of which is a second identity layer:
change. The cell can emit no cell-owned mutation, and no subject is ever
spoken for by an arena.
Debt rotation makes the choke fair: with N subjects and budget B, every
subject reaches a singleton cell within about N/B ticks absent a mandatory
foreground override, and the deterministic clocks keep its commitments moving
in between.
Debt rotation makes the choke fair. With N active subjects, a cell budget B,
and U urgency slots reserved for the head of the attention order, the
rotation reserve is R = B − U, and a subject continuously active for
ceil(N/R) ticks with stable membership is a singleton at least once. ceil(N/B)
is unreachable whenever N > B, because it would leave subjects uncovered. The
constituent cap yields for two reasons, when the budget's token capacity is
short of the active count and when connected components cannot pack inside
the cell budget even with capacity to spare; the cell budget never yields;
`oversubscribed` is the operator-visible signal that the cap gave way. The
cover is pure over its inputs and the attention order is a real input: the
same subjects in a different order give the same coverage and a different
singleton set, because urgency and backfill read that order. The deterministic clocks keep commitments moving in
between.
A grouped cell buys one inference, never one admission rule. Its constituents
are grouped because they are connected, so they are the subjects most likely
to contend: each attributed proposal binds to its own scope digest, and when
the first act lands (a telling changes a co-located listener's knowledge),
the second is refused `ScopeChanged` rather than committed on a stale scope.
Declines are submitted first so silent constituents consume their turn
without contention, and the driver reports submitted against committed per
cell so the gap is visible. The cover did not create the contention; two
singleton cells for the same pair would contend identically, and a refused
constituent costs one admission check rather than one inference. The grouping
heuristic stays. The open decision for the operator, to be taken with the
submitted-versus-committed number in hand, is whether a refused constituent
gets one bounded re-submission against its re-derived opportunity inside the
same tick, which costs no inference.
## What stays open

View file

@ -225,56 +225,72 @@ outcome bands, four derived `CausalBoundary` kinds, scope-digest binding, one
are teardown evidence. Plan step 6 is nine implementation passes; pass 1 is
landed, passes 2 through 9 are not.
1. Passes 1 through 8 are integrated; nothing beyond pass 8 is.
`codex/ghostlight-dungeon-mvp` tip is `3ed3868` (Soul) over `2252370`
(pass 8 machine), on `106e7ef` (pass-7 docs and handoff) and `5874fc2`
(pass-7 follow-ups). Earlier passes: `5e53beb`, `e99af63`, `d2805fe`,
`0f21a49`, `dbe176d`, `cb6a126`, `1852ddd`. The push follows a background
crate test and the branch read `ahead 2` at the time of writing;
`git status -sb` is the witness.
1. Passes 1 through 9 are integrated; the ontology widening machine is
complete and only pass 10 (consumer ingress) remains in step 6.
`codex/ghostlight-dungeon-mvp` tip is `8aebfb6` (Soul) over `f013c1d`
and `71d8c53` (Hands, pass 9), on `7dbbc81` (pass-8 docs and handoff) and
`b5443d5` (pass-8 follow-ups). Earlier passes: `5e53beb`, `e99af63`,
`d2805fe`, `0f21a49`, `dbe176d`, `cb6a126`, `1852ddd`, `3ed3868`. The
push follows a background crate test and the branch read `ahead 3` at
the time of writing; `git status -sb` is the witness.
Pass 8 facts: new modules `world/tool_schema.rs` and
`world/elaboration.rs`; `SystemCapability::Elaborator { jurisdiction }`;
`require_patch_author` and `confine_to_jurisdiction` at both `reduce` and
`apply_effect`; `Mismatch::OutsideJurisdiction`; `PATCH_TOOLS` (37
tools); `ElaborationPort` with `submit_elaboration` is the only authoring
door into the world; `ControllerWork::Elaboration` and `WorkLane`;
`ElaborationRunner` wired to the runtime task `elaborate_world`
(`runtime.rs`) with `ControllerModels.elaborator` from the environment
variable `GHOSTLIGHT_CONTROLLER_ELABORATOR_MODEL`; `NullEvidenceSource`
is what production supplies today. Schemas are
`world_state.elaboration.v1` / `world_commit.elaboration.v1` and
`controller_work.v7`, earlier stores refused. Soul drove the repair loop
end to end (spec test 20 exists in `controllers.rs`). Rulings adopted:
the owner remains unconfined; the elaborator is confined at both answer
and write; boundaries cover transitively and deficit rows are exact-key;
canonical facts from the elaborator lane are bounded by `filter_evidence`,
and with `NullEvidenceSource` none can land; one spelling of the patch
schema, `composite_schema` owns and the example derives from it (that
last one is a follow-up in flight). Baseline at `3ed3868`: 253 test
functions in `world/*.rs`, 293 crate source, plus one integration test
(the focused `world::` run reports 252 / 288; different counting rules,
compare like with like). The ontology doc operation count now reads 27
at all three sites; that queued item is closed.
Pass 9 facts: new module `world/cover.rs` (`TickIndex`, `Resolution`,
`CellId`, `Cell`, `Cover`, `CoverBudget`, `AgencyGraph`, `derive_cover`);
`ControllerWork::Grouped` with `GroupedCheckpoint`;
`InferencePurpose::GroupedAgent`; owner-only `Request::AgencyGraph`,
port-narrowed rather than principal-authenticated; the runtime task
`drive_cover_tick` (`runtime.rs`) is the single owner of tick cadence,
cover derivation, and the clock, and advances the clock after the cells
(the pass-7 `advance_world_clock` task is gone, verified absent from
source); a `Semaphore` plus `AtomicBool` quarantine replaced the
controller mutex; environment `GHOSTLIGHT_COVER_CELL_BUDGET`,
`GHOSTLIGHT_COVER_CONSTITUENT_CAP`, `GHOSTLIGHT_COVER_URGENCY_SLOTS`,
`GHOSTLIGHT_CONTROLLER_MAX_CONCURRENT`, `GHOSTLIGHT_TICK_INTERVAL_SECONDS`;
`controller_work.v8`; world state and commit schemas stay at
`elaboration.v1`; no `Cargo.toml` change and no `uuid/v5`, verified.
Rulings adopted: fairness is ceil(N/R) with R = cells minus urgency
slots, verified at the 2,400/240 profile to close in 22 ticks, not 21;
the constituent cap yields for two reasons, capacity and packing, while
the cell budget never yields and oversubscribed is the signal; the cover
is pure and the attention order is a real input; coupled constituents in
a grouped cell contend and the second act is honestly refused with
`ScopeChanged`, and the grouping heuristic stays; the open operator
decision is whether to allow a bounded in-tick re-submission for a
refused constituent, to be taken with the submitted-versus-committed
number in hand. The owner-only Eve `world.run_tick` command is not built;
its authority decision is pending. Baseline at `8aebfb6`: 283 test
functions in `world/*.rs`, 323 crate source, plus one integration test
(the focused `world::` run reports 282 / 318; different counting rules,
compare like with like).
In flight, not landed, both branched from `3ed3868` with no commits yet at
the time of writing:
- `hands/pass8-followups` in the worktree `F:\Projects\Ghostlight-pass8fu`:
`variant_content` spells unit variants so `Bounds::None` is reachable;
`composite_example` deleted and derived from the schema; the forged-row
test fixed or deleted; `every_declaration` / `every_component_op`
exemplar lists; the dead-code expectation removed.
- `hands/pass9` in the worktree `F:\Projects\Ghostlight-pass9`: budgeted
connected cover, from `imagination-pass9.md`.
In flight, not landed:
- `hands/pass9-followups` in the worktree `F:\Projects\Ghostlight-pass9fu`,
branched from `8aebfb6` with no commits yet: `with_test_ports`,
`InferencePort`, and `ControllerWorkStore` to `pub(crate)` with spec
test 13.12 for concurrency plus quarantine; `drive_cover_tick` behind
narrow ports with an ordering test; `merges_are_deterministic_in_subject_order`
retired.
- Pass 10 design: `modeling-pass10.md` is on disk in the session
scratchpad; `imagination-pass10.md` is being written under ten rulings,
the load-bearing ones being: the consumer is a third `SystemCapability`
arm confined to one externally controlled subject; externally
controlled subjects get no opportunity and are skipped by the cover;
one atomic verdict per document, no partial acceptance; one kernel-side
decode bound for both lanes; transport follows the `POST
/cultnet/snapshot` precedent, not an `execute_world` literal; a
`ConsumerPort` as narrow as `ElaborationPort`; no Delvehold names in
core. No pass-10 worktree exists yet.
Main carries uncommitted coordinator edits to
`docs/architecture/ghostlight-world-ontology.md` and
`docs/architecture/ghostlight-world-consumer-api.md` (in progress at the
time of writing); the pass-8 "Current mechanism" text is owed and lands
with the follow-ups. Witness
for any later pass: main-branch `git log` past `3ed3868`, and
`git worktree list` for the two trees.
`docs/architecture/ghostlight-world-ontology.md` (pass-9 scale paragraph,
the contention finding, and two stale claims Modeling caught: `AdmitPatch`
has no phase gate of its own, and `EvidenceRef::new` is `pub(super)`
bounded by `filter_evidence`, not `#[cfg(test)]`),
`docs/architecture/ghostlight-dungeon-mvp.md` (derived state, membrane,
tick driver and environment values), and the plan's step-6 pass-10 line.
Witness for pass 10: main-branch `git log` past `8aebfb6`, and
`git worktree list`.
Pipeline for pass 9 and pass 10: specs `imagination-pass1.md` through
Pipeline for pass 10: specs `imagination-pass1.md` through
`imagination-pass9.md` and maps `modeling-pass1.md` through
`modeling-pass9.md` are on disk in the session scratchpad
`C:\Users\Meta\AppData\Local\Temp\claude\F--Projects-Ghostlight\2fd50f5e-f7ba-4e5d-82bc-c7033e6074d2\scratchpad`,
@ -296,14 +312,11 @@ landed, passes 2 through 9 are not.
(consumer ingress) carries four named debts: authority, decode-time size
bounds, phase, and boundary answering, plus the `mesh.rs` inbound ruling.
Queued doc edits, coordinator-owned: the pass-8 "Current mechanism"
section; ontology Invariant 11 and Verification 16 for the expansion rule
and covering asymmetry; the Active phase bounded by the answer with two
`AdmitPatch` authors; `ghostlight-world-consumer-api.md` stays marked
drift until pass 10 and should name its four debts and the `mesh.rs`
inbound ruling; the `GHOSTLIGHT_CONTROLLER_ELABORATOR_MODEL` setting in
the config doc; after pass 9, the ontology doc phrase "within about N/B
ticks" becomes ceil(N/R) with R the rotation reserve.
Queued doc edits, coordinator-owned: the pass-9 "Current mechanism"
paragraph, written with the follow-ups; and a config note for
`GHOSTLIGHT_CONTROLLER_ELABORATOR_MODEL`, which no doc names yet. The
pass-9 environment variables are in the uncommitted mvp edit (line 449)
and the ceil(N/R) wording in the uncommitted ontology edit (line 601).
2. First-generation world fixtures are banked and pushed, one per world, each
with Ink, training sidecar, visual plan, lore grounding, and BFL manifest,
reviewer-accepted except visual replay, which waits on a scene-set

View file

@ -280,8 +280,9 @@ Implementation order, each pass landing tests before the next begins:
never sees a cell.
10. Consumer ingress: the typed CultNet ingress through which an external
consumer submits a `WorldPatch` or proposal to the sealed kernel. Until
this lands no production path deserializes a `WorldPatch`;
`EvidenceRef::new` stays `#[cfg(test)]`.
this lands the elaborator lane is the only production author of a
`WorldPatch`, and the kernel has no decode-time bound of its own; pass 10
gives it one owner for both lanes.
The deployment cutover (step 5) is deferred behind this stage, not cancelled. No
world acceptance run may start while Yggdrasil serves the legacy body.

File diff suppressed because one or more lines are too long

View file

@ -2,11 +2,12 @@
## Current Subgoal
Plan step 6 pass 9 (budgeted connected cover, scheduler-owned, kernel never
sees a cell) with Hands in `F:\Projects\Ghostlight-pass9` on `hands/pass9`,
alongside the pass-8 follow-ups in `F:\Projects\Ghostlight-pass8fu` on
`hands/pass8-followups`; both from `3ed3868`. Main tip `3ed3868`, passes 1-8
integrated. Pass 9 must not enable `uuid/v5`.
Pass-9 follow-ups with Hands in `F:\Projects\Ghostlight-pass9fu` on
`hands/pass9-followups` from `8aebfb6`, and pass 10 (consumer ingress) design:
`modeling-pass10.md` on disk, `imagination-pass10.md` in progress under the
ten rulings. Main tip `8aebfb6`, passes 1-9 integrated. Open operator
decisions: bounded in-tick re-submission for a refused constituent; Eve
`world.run_tick` authority.
## Working Notes