Ghostlight/docs/public-architecture/Runtime pipelines.md
2026-08-31 20:10:26 +02:00

98 lines
5 KiB
Markdown

---
title: Runtime pipelines
description: End-to-end Ghostlight flows from campaign negotiation to newspapers.
---
## Session Zero and publication
1. A Projector lowers permitted shared or private negotiation state.
2. The persistent DM Persona speaks naturally with the players.
3. The Session Zero Interpreter extracts only newly proposed typed changes.
4. Material bargains remain unresolved until the exact owner accepts them.
5. Evidence retrieval and the compiler produce an approval preview.
6. Campaign, membership, contract, DM Persona, evidence, and seed digest publish
atomically before the campaign becomes discoverable.
## World compilation
1. Retrieval planners formulate bounded Vault queries.
2. Evidence relevance classifies direct seed evidence separately from
background and excluded material.
3. The compiler proposes local topology, actors, institutions, populations,
clocks, facts, and civic machinery.
4. Agency stages profile every non-player strategic subject and compile
relations and doctrines.
5. Deterministic validation checks topology, identity, evidence, knowledge,
civic closure, and authority.
6. Compatible missing detail may be reconciled on a private bounded workbench.
7. The registry publishes the accepted seed as an empty-store creation
transaction. Runtime models never gain a parallel creation path.
## Foreground turn
1. The speech-address resolver chooses exact co-present addressees.
2. Each affected participant receives its own Projector and Persona appraisal.
3. Direct addressees must speak or choose deliberate silence.
4. The Interpreter lowers proposed intent into the closed action algebra.
5. Mutation-scope preflight removes impossible effect lanes.
6. The assessor decides possibility, DC, stakes, and outcome ceilings.
7. The player accepts the exposed risk; the server rolls.
8. An effect verifier checks that the chosen typed consequence follows from the
attempted means and supplied authority.
9. `WorldKernel` commits the whole result and event atomically.
## Strategic wave
1. Resolution demand weights geography, ideology, authority, economy, body or
species, and information for the current horizon.
2. The deterministic partitioner derives a connected cover under the active
cell entitlement.
3. Nemesis searches committed causal anchors and assigns exact responders that
genuinely need a decision window. It may assign nobody.
4. Every selected cell runs Projector → Persona → Interpreter independently and
in parallel under a separate provider semaphore.
5. Cell effect verification rejects actions that borrow another constituent's
knowledge or authority.
6. The strategic outcome resolver proposes one bounded result per admitted
action; a separate outcome verifier checks selective semantic risks.
7. Optional individuation may name one person whose political work can no
longer remain anonymous.
8. `WorldKernel` validates the complete wave, advances time and clocks, commits
state and events atomically, then refreshes public projections.
## World elaboration
1. A consumer scale intent and current canonical subject count derive the
actionable-subject target and deficit.
2. Realm complexity weights distribute that target; the active cell budget and
provider concurrency remain separate controls.
3. The elaboration scheduler dispatches titled workers in proportion to their
user-controlled slider shares.
4. Locality passes propose exactly one additive place, route, fact,
institution, relation, or civic operation. Complexity passes propose one
Gestalt fission or one grounded individual promotion against a distinct
frozen parent.
5. Complexity proposals run concurrently, then rebase only when their exact
parent state is unchanged and serialize through `WorldKernel`. Successful
commits are checkpointed individually; a retry replays only failed calls.
6. Every title that committed work receives one bounded agentic compaction
turn. Its narrative frontier is checkpointed beside deterministic commit
ancestry, so provider-session eviction cannot erase or rewrite history.
7. The driver recounts canonical active agency leaves and derives another
round until the target cover ratio is met. Resolution then builds its
disposable cell cover independently.
## Newspaper
1. The assignment editor queries the immutable public-event ledger and selects
an issue shape, throughline, stories, evidence, and the best reporter for
each assignment.
2. Recurring in-world journalists write from individual beats, biases, source
habits, voices, and blind spots. Their job is narrative, not factual
admission.
3. The copy desk performs one factual review and returns a complete checklist.
4. The Night Editor receives the assembled page and that checklist once,
repairs what it can while preserving the story, and closes at deadline.
5. Deterministic provenance binds every factual assertion to exact committed
sources. Errors found after close become correction memory for a later
edition rather than an infinite rewrite loop.