Document GhostlightDungeon authority and Persona ownership

This commit is contained in:
Meta Vens 2026-08-16 16:26:39 +02:00
commit 9953ecf231
7 changed files with 459 additions and 14 deletions

View file

@ -0,0 +1,389 @@
# GhostlightDungeon MVP Architecture
## Objective
GhostlightDungeon is a persistent single-player narrative simulation grounded
in a source-owned worldbuilding Vault. It gives the world stable geography,
bounded knowledge, durable actors and institutions, explicit consequence, and
motion beyond the player's attention. The player describes attempts. The world
decides what is possible, what is opposed, and what changes.
The MVP runs as a Rust daemon on Starfire and publishes a private Eve/CultUI
surface for two invited testers. Aetheria is the bundled setting adapter. The
core world, Persona, and Vault contracts remain setting-neutral.
Ghostlight's existing v0 schemas and Pallas, Lucent, and Corvid fixtures are
evidence and regression scenarios. They do not own runtime state or commits.
## Body and faculty map
| Faculty | Owner | Body | Authority |
| --- | --- | --- | --- |
| Self | `WorldKernel` campaign mailbox | One campaign `.cc` store | Orders commands and owns the campaign revision |
| Eyes | `VaultProvider` and actor perception slices | VoidBot MCP receipts, topology, occupancy, knowledge | Retrieves and witnesses; never commits world truth |
| Modeling | World compiler and action assessor | Typed campaign snapshot | Proposes topology, facts, affordances, DC, stakes, and gaps |
| Imagination | Persona and world proposal stages | Private narrative projections | Proposes speech, private deltas, reactions, and actions |
| Hands | `WorldCommand` commit path | CultCache/redb transaction | Performs the single allowed state transition |
| Soul | Validators, version gates, receipts, tests | Schemas, invariants, state and visible-path probes | Refuses stale, malformed, impossible, or unsupported mutation |
| Persona | Ghostlight Persona runtime | Narrative stream in, natural narrative out | Acts as a person without seeing schemas or raw canonical state |
| Nervous system | Scheduler, live-priority gate, CultMesh | Mailboxes, pulses, typed publications | Carries commands, pressure, progress, and projections |
## Authority map
### Owner
The per-campaign `WorldKernel` is the sole owner of canonical campaign state and
revision numbers. Each kernel is reached through one in-process mailbox. There
is no alternate scheduler writer, HTTP writer, model writer, import writer, or
reload repair path.
### Inputs
The kernel may read:
- the current typed campaign snapshot from its owned CultCache store;
- one typed `WorldCommand` carrying an expected revision where applicable;
- validated proposal documents and exact evidence receipts referenced by that
command;
- server-owned clock and random-number ports;
- deterministic capability, custody, spatial, knowledge, resource, opposition,
and topology rules.
Model prose is never itself a kernel input. An Interpreter must first convert
it to a typed proposal, which local validation can reject without mutation.
### Outputs
An accepted command atomically replaces the campaign snapshot and appends a
`world_commit_receipt.v1`. A resolved attempt also appends its
`roll_receipt.v1`. Other stages receive the new committed revision only after
the transaction succeeds.
A rejected command produces a typed rejection receipt or ephemeral assessment
result. It does not modify the campaign.
### Derived state
- A scene is derived from persistent occupancy, containment, route topology,
perception, and current events. A scene is not a location owner.
- The transcript is a projection of committed events and speech. It is not
memory or world truth.
- Eve surfaces, chat cards, ledgers, news drawers, operator views, and HTTP
health are projections of CultMesh-visible provider state.
- Assessments are expiring previews bound to one campaign revision. They are
not commands and are never rebased.
- Initiative is a compatibility and opportunity decision over proposals. It
cannot commit.
- News is a character-accessible projection of committed offscreen events. It
cannot reveal or alter omniscient state.
- Model-stage records are private receipts. They do not become facts merely
because a model said them.
### Forbidden writers
The following may never decide or repair canonical campaign truth:
- browser handlers and chat transport;
- Eve renderers and command lowering;
- DeepSeek responses;
- Projectors, Personas, Interpreters, narrators, retrievers, rerankers, and
verifiers;
- initiative and reaction selection;
- scheduler loops and return-time catch-up calculations;
- Vault providers and evidence caches;
- import, fork, export, reset, or reload handlers;
- health endpoints, operator tools, and debug probes.
Each must submit the same typed command accepted by the campaign mailbox or
remain a read-only projection.
### Shared paths
Player speech, assessed attempts, confirmed rolls, waits, travel, NPC actions,
institution actions, strategic ticks, campaign creation approval, imports, and
reload recovery all use:
```text
source intent
-> typed WorldCommand
-> mailbox ordering
-> expected-revision check
-> deterministic validation
-> atomic CultCache commit
-> commit receipt
-> post-commit appraisal/projection wave
```
The scheduler may calculate pending work, but `AdvanceStrategicTick` owns the
transition. Return catch-up invokes that same command before the next player
action is admitted.
### Cut line
Ghostlight has no existing hosted runtime authority to preserve. The v0
training pipeline remains intact as evidence. New runtime code must not route
through its JSON fixtures or promote fixture documents into live state.
The Persona machinery currently embedded in Epiphany is a separate ownership
cut. Ghostlight will extract and generalize the projection protocol; Epiphany's
domain state and public Persona remain Epiphany-owned. No compatibility path may
allow Epiphany's old local projection implementation and Ghostlight's shared
implementation to make competing decisions after migration.
## Persona projection ownership
### The ownership decision
Ghostlight owns the reusable Persona projection machinery:
1. permissioned typed-state slicing;
2. typed slice to private lived-narrative projection;
3. Persona invocation using only that lived narrative;
4. natural narrative output to typed private deltas, explicit speech, reaction
priority, and `WorldActionProposal` interpretation;
5. stage receipts, snapshot binding, validation, and failure isolation;
6. parallel appraisal waves for every affected present participant.
This organ is useful outside games. Its invariant is that a Persona experiences
a bounded narrative world without receiving the machinery's schemas or raw
state, while the surrounding system receives only typed proposals rather than
unreviewed narrative mutation.
Ghostlight does **not** own a consuming Persona's canonical mind. Epiphany owns
Epiphany's Persona state, voice, memories, relationships, values, permissions,
public identity, and accepted consequences. VoidBot owns its repo and companion
Persona state. Ghostlight supplies the reusable organ through narrow typed
ports.
### Extraction from Epiphany
Before moving code, map Epiphany's current projection body:
- owner of canonical Persona state;
- projector inputs and hidden prompt inputs;
- narrative stream contract;
- Persona model invocation and tool boundary;
- Interpreter outputs;
- mutation/commit authority;
- model transport, retries, receipts, and telemetry;
- Epiphany-specific assumptions embedded in otherwise general code.
Classify each part:
- **Move to Ghostlight:** general narrative projection, Persona invocation,
interpretation, schema validation, stage receipt, and concurrency machinery.
- **Stay in Epiphany:** Epiphany state schemas, state store, relationship and
memory authority, public voice policy, tools, schedules, and consequence
decisions.
- **Split at a port:** state slicing, model selection, retrieval, clocks,
receipts, and commit callbacks where both projects need control but only one
owns each decision.
- **Delete:** duplicate local orchestration or adapters that preserve two
projection authorities.
### Handing the organ back to Epiphany
Epiphany consumes the Ghostlight projection crate/service through a pinned
contract. Her adapter supplies:
- an Epiphany-owned permissioned state slice;
- a snapshot version and actor identity;
- Epiphany-owned model and retrieval policy where the port permits it;
- a callback or command boundary that accepts typed proposals for Epiphany's
own validation and commit path.
Ghostlight returns narrative output, typed proposals, and stage receipts.
Ghostlight never writes Epiphany's canonical state. Epiphany's existing local
projection writer is deleted or reduced to the adapter before the shared path
is considered live.
Migration acceptance requires a replay corpus showing that the shared organ
preserves or improves character performance, plus negative tests proving the
old Epiphany path cannot still commit, override, or repair the new path.
## Runtime organs
### Campaign store
Each campaign has one row-oriented MessagePack CultCache `.cc` store backed by
redb. The daemon holds the store's exclusive owner lock for the kernel lifetime.
The runtime root is `F:\GameCult\GhostlightDungeon` with separate service,
campaign, receipt, export, and release directories. Service catalog and control
state use their own `.cc` store.
JSON exists only for published JSON Schemas and browser, MCP, and model-provider
boundaries. It is not load-bearing runtime state.
### Vault provider and world compiler
`VaultProvider` exposes source search, surrounding context, exact documents,
source witnesses, authority lanes, and temporal scope. The Aetheria adapter
calls VoidBot's canonical MCP retrieval endpoint at Starfire loopback. It stores
exact evidence receipts used by the campaign, never vectors or a rival index.
Compilation is staged and approval-gated:
```text
opening request
-> retrieval plan
-> exact evidence receipts
-> three distinct openings or custom opening
-> three grounded roles or custom role
-> bounded region + institutional pressure graph
-> coverage/gap/assumption preview
-> explicit approval
-> CreateCampaign commit
```
Reversible local texture may enter as provisional branch fact. Material gaps in
geography, mechanics, institutions, or extraordinary capability require
approval. Canon candidates are review/export records and cannot edit the Vault.
### Fiction-first resolution
`Assess` normalizes intent and intended effect, checks admissibility, selects a
DC from 5/10/15/20/25/30, itemizes referenced context modifiers, caps their sum
at ±10, states the effect ceiling and outcome stakes, and issues an expiring
digest bound to the current revision.
`Attempt` consumes that exact assessment. It obtains an OS-random d20 inside the
server command path and atomically stores roll and transition. Impossible acts
receive no roll. Natural 20 and 1 shift one band and cannot cross impossibility
or the effect ceiling. Speech occurs as speech; persuasion, deception, and
intimidation are separate intended effects.
### Actor and world action loop
After a committed event, every affected present actor receives a parallel
appraisal wave. Each actor gets only its perceived slice, private memories,
relationships, goals, and retrieved knowledge. Actor-private deltas are bound
to their own snapshot versions. Initiative selects compatible reactions for a
later `WorldCommand`; it does not suppress perception for actors outside the
current conversational focus.
### Away-time agency
The service pulses every five minutes. After fifteen minutes without player
activity, each real hour earns one pending strategic tick, capped at eight.
Live play prevents new background model calls from launching. The absent player
is not puppeted or directly harmed. Remote actors and institutions may move,
prepare, recruit, investigate, bargain, obstruct, spend resources, and advance
clocks. Information-channel-aware news is projected only if the player
character can access its channel.
### Eve/CultMesh and browser
Ghostlight publishes `gamecult.eve.surface.v1` and accepts typed Eve commands.
The TypeScript browser host pins Eve's browser lowering package and owns only
transport, sessions, and local rendering. It does not invent a parallel UI
state model.
The player surface includes compilation, transcript, composer, Assess/Attempt,
roll confirmation, Wait, character ledger, current place/time/pressure, news,
campaign management, fork/reset/export, and optional operator inspection.
CultMesh state is the source of the UI projection. HTTP health is a probe over
the same service-state document.
## Model boundary
The provider-neutral model port records provider, model, request hash, source
receipt ids, latency, output hash, validation result, and state version.
Structured stages request JSON Output and then validate locally. Empty or
malformed output gets one retry against the same snapshot. A second failure,
timeout, retrieval outage, or stale result produces no mutation.
Live model allocation:
- `deepseek-v4-flash`, non-thinking: projection, interpretation, retrieval
planning/reranking, verification, and offscreen actors;
- `deepseek-v4-pro`, non-thinking: compilation, action assessment, live
Personas, and narration.
`reasoning_content` is neither persisted nor displayed.
## Hosting and security
The daemon serves the embedded browser bundle on TCP 8831. Firewall scope is
Starfire's private LAN and `10.77.0.0/24`; there is no public listener or
Yggdrasil web gateway. Two single-use invites establish separate HttpOnly
sessions. Campaigns remain single-player.
The Windows service uses a dedicated virtual service identity. Runtime ACLs
permit only administrators and that identity. Setup reads the DeepSeek key from
stdin and writes a machine-scoped DPAPI secret with restricted ACLs. The key is
absent from source, arguments, logs, environment projections, and exports.
Releases are immutable directories built from exact commits. Activation is an
atomic pointer switch, recorded in CultCache. The service has restart recovery
and the rollback runbook lives in `gamecult-ops`.
Live VoidBot integration remains gated on independent verification of the SSH
host fingerprint, reconciliation of Yggdrasil inventory/DNS, repair of the
Starfire tunnel task from `E:\Projects` to `F:\Projects`, and restoration of
`127.0.0.1:17875/mcp`. Retired local VoidBot/Qdrant writers stay retired.
## Public contracts
Ghostlight publishes JSON Schema for:
- `ghostlight.vault_manifest.v1`
- `ghostlight.vault_evidence_receipt.v1`
- `ghostlight.world_compile_preview.v1`
- `ghostlight.campaign.v1`
- `ghostlight.world_fact.v1`
- `ghostlight.location.v1`
- `ghostlight.actor_state.v1`
- `ghostlight.institution_state.v1`
- `ghostlight.relationship_state.v1`
- `ghostlight.world_clock.v1`
- `ghostlight.event.v1`
- `ghostlight.player_action_assessment.v1`
- `ghostlight.roll_receipt.v1`
- `ghostlight.world_commit_receipt.v1`
- `ghostlight.persona_stage_receipt.v1`
- `ghostlight.actor_state_delta.v1`
- `ghostlight.world_action_proposal.v1`
- `ghostlight.strategic_tick.v1`
- `ghostlight.news_issue.v1`
- `ghostlight.canon_candidate.v1`
The UI consumes existing `gamecult.eve.surface.v1` and
`gamecult.eve.command.v1` contracts.
## Implementation order
1. Freeze this authority map and publish v1 schemas.
2. Map Epiphany's current projection machinery and record move/stay/split/delete
decisions before extraction.
3. Build CultCache campaign persistence and the mailbox-owned kernel.
4. Prove shared command paths, revision checks, topology, knowledge, custody,
assessment, roll, and atomic failure invariants with injected ports.
5. Extract the generalized Persona projection organ into Ghostlight and replay
Epiphany/Ghostlight fixtures through it.
6. Add fixture Vault/model ports, compiler approval, actor appraisal waves, and
away-time commands.
7. Add the VoidBot and DeepSeek production adapters without granting either
commit authority.
8. Publish the CultMesh/Eve surface and thin authenticated browser host.
9. Add service installation, DPAPI setup, release activation, firewall, and
rollback tooling under the correct repository owners.
10. Run fixture regressions, invariant fault tests, browser acceptance, and the
final Starfire deployment smoke.
## Acceptance and negative proof
Acceptance follows the user-approved MVP scenarios. In addition, every claimed
invariant needs a negative proof at its visible layer:
- stale HTTP, scheduler, model, Persona, import, and reload paths cannot commit;
- leaving a scene cannot delete or reconstruct its location;
- an actor without perceived evidence cannot gain the corresponding knowledge;
- malformed or empty model output cannot partially update actor-private or
world state;
- the old Epiphany projection path cannot commit or repair after migration;
- browser state and operator probes report the same campaign revision and
deployed commit as CultMesh/CultCache;
- background launch pressure yields before a live player inference wave;
- unauthenticated, reused-invite, public-network, and cross-session campaign
access are rejected.

View file

@ -27,6 +27,18 @@ behavior, major faction decision-making, and technology/item manifest generation
## Current Focus
GhostlightDungeon is the active MVP. Read
`docs/architecture/ghostlight-dungeon-mvp.md` before touching its runtime. The
per-campaign WorldKernel mailbox is the sole canonical writer. Ghostlight owns
the generalized Projector → Persona → Interpreter organ; Epiphany retains her
canonical Persona mind and will consume the shared organ through an adapter.
The immediate next action is to map Epiphany's existing projection machinery
into move/stay/split/delete ownership before continuing the Rust scaffold.
Existing Ghostlight fixtures remain regression evidence.
## Prior research pipeline focus
The active path is a source-grounded branching-scene data loop:
1. Source-ground Aetheria context.
@ -322,13 +334,11 @@ steering surfaces unless the user explicitly asks for archaeology.
## Current Next Action
Choose the next bounded move: backfill Corvid/NeuroSyn room-scale lore gaps,
convert the Corvid fixture into a true scene-loop receipt chain, backfill the
useful Lucent lore gaps into AetheriaLore, build a visual/scene-set pass for the
Lucent IF, or move to the next coverage fixture. Current accepted full-fixture
coverage is still empty; Pallas, Lucent, and Corvid derivatives are draft rows
with per-organ training readiness or reference-only value, not accepted broad
corpus fixtures.
Inventory Epiphany's current Persona projection body with source references:
canonical state owner, slice inputs, projector, narrative contract, Persona
invocation, Interpreter, commit boundary, receipts, model transport, and
Epiphany-specific policy. Record move/stay/split/delete decisions in the
GhostlightDungeon architecture before moving implementation code.
## Warnings

View file

@ -1,7 +1,25 @@
# Ghostlight Current System Map
Ghostlight does not have a full runtime yet. The live system is a set of
validated artifact seams for producing reviewed training data.
GhostlightDungeon is the active runtime program. Its authority map is
`docs/architecture/ghostlight-dungeon-mvp.md`. The runtime is not yet complete;
the existing validated artifact seams remain regression evidence.
## GhostlightDungeon target flow
```text
Vault evidence receipts + typed campaign snapshot
-> permissioned projection
-> Persona receives private lived narrative only
-> Interpreter emits typed deltas and action proposals
-> deterministic gates + expected revision
-> one WorldCommand enters the campaign mailbox
-> atomic CultCache commit + receipt
-> parallel affected-participant appraisal
-> CultMesh/Eve projection
```
Ghostlight owns the generalized projection organ. Epiphany and other consumers
own their canonical Persona state and consequence commits.
## Control Flow

View file

@ -2,6 +2,20 @@
## Current Phase
GhostlightDungeon is now the active implementation program. Its authoritative
architecture and ownership map is
`docs/architecture/ghostlight-dungeon-mvp.md`. The existing data-generation
pipeline and fixtures remain regression evidence; they do not become hosted
runtime authorities.
The first required cut is documentation and extraction mapping: inventory the
Projector → Persona → Interpreter machinery currently embedded in Epiphany,
classify move/stay/split/delete ownership, and only then continue runtime code.
Ghostlight owns the generalized projection organ. Epiphany keeps her canonical
Persona mind and consumes the shared organ through a narrow adapter.
## Prior research-program phase
Build a reliable data-generation loop for socially persistent Aetheria agents.
The immediate target is not a full simulation. It is a clean, reviewed,
sandboxed training-data pipeline for branching scenes and state consequences.

View file

@ -65,4 +65,5 @@
{"note": "VoidBot's new routine should become Ghostlight's cast swarm timing and memory substrate: characters take scene turns through heartbeat initiative, offstage agents use slower rumination/sleep turns for consolidation, canonical state moves toward CultCache-style MessagePack with JSON projections, and memory resonance/incubation/dream state should be backed by Qdrant vectors. Captured the plan in docs/architecture/voidbot-routine-adoption-plan.md.", "status": "ok", "ts": "2026-05-06T00:25:00+00:00", "type": "architecture"}
{"note": "Ghostlight began migrating machine-managed persistent state behind cultcache-py: branch and evidence records now route through a registered CultCache seam with readable JSON exports kept for diffability and compatibility.", "status": "accepted", "ts": "2026-05-06T03:46:41+00:00", "type": "architecture"}
{"note": "CultCache wire contract clarified: DatabaseEntry payloads must be MessagePack arrays indexed by explicit field keys with nil gaps for reserved/deleted slots; cultcache-py now exposes define_database_entry_type for that contract and CultLib generator was patched to preserve sparse key slots.", "status": "accepted", "ts": "2026-05-06T03:57:10+00:00", "type": "architecture"}
{"ts": "2026-05-06T04:49:20+00:00", "type": "architecture", "status": "accepted", "note": "Ghostlight agent-state schema is now the first shared cross-runtime payload contract. CultNet clients should carry ghostlight.agent_state.v0 unchanged inside typed document envelopes, with CultLib-style auth/session semantics handled by the transport layer rather than bespoke per-repo glue."}
{"note": "Ghostlight agent-state schema is now the first shared cross-runtime payload contract. CultNet clients should carry ghostlight.agent_state.v0 unchanged inside typed document envelopes, with CultLib-style auth/session semantics handled by the transport layer rather than bespoke per-repo glue.", "status": "accepted", "ts": "2026-05-06T04:49:20+00:00", "type": "architecture"}
{"ts": "2026-08-16T14:26:32+00:00", "type": "architecture", "status": "accepted", "note": "GhostlightDungeon ownership map accepted: Ghostlight owns generalized Projector-Persona-Interpreter machinery; consuming Personas such as Epiphany retain canonical mind and commit authority through narrow adapters. WorldKernel is the sole campaign writer."}

View file

@ -67,3 +67,4 @@
{"key": "2026-05-06T034641Z0000-0065-ea57d8ad2b40", "payload": "eyJub3RlIjogIkdob3N0bGlnaHQgYmVnYW4gbWlncmF0aW5nIG1hY2hpbmUtbWFuYWdlZCBwZXJzaXN0ZW50IHN0YXRlIGJlaGluZCBjdWx0Y2FjaGUtcHk6IGJyYW5jaCBhbmQgZXZpZGVuY2UgcmVjb3JkcyBub3cgcm91dGUgdGhyb3VnaCBhIHJlZ2lzdGVyZWQgQ3VsdENhY2hlIHNlYW0gd2l0aCByZWFkYWJsZSBKU09OIGV4cG9ydHMga2VwdCBmb3IgZGlmZmFiaWxpdHkgYW5kIGNvbXBhdGliaWxpdHkuIiwgInN0YXR1cyI6ICJhY2NlcHRlZCIsICJ0cyI6ICIyMDI2LTA1LTA2VDAzOjQ2OjQxKzAwOjAwIiwgInR5cGUiOiAiYXJjaGl0ZWN0dXJlIn0=", "stored_at": "2026-05-06T03:46:41.487861+00:00", "type": "ghostlight.evidence_record.v0"}
{"key": "2026-05-06T035710Z0000-0066-272010506962", "payload": "eyJub3RlIjogIkN1bHRDYWNoZSB3aXJlIGNvbnRyYWN0IGNsYXJpZmllZDogRGF0YWJhc2VFbnRyeSBwYXlsb2FkcyBtdXN0IGJlIE1lc3NhZ2VQYWNrIGFycmF5cyBpbmRleGVkIGJ5IGV4cGxpY2l0IGZpZWxkIGtleXMgd2l0aCBuaWwgZ2FwcyBmb3IgcmVzZXJ2ZWQvZGVsZXRlZCBzbG90czsgY3VsdGNhY2hlLXB5IG5vdyBleHBvc2VzIGRlZmluZV9kYXRhYmFzZV9lbnRyeV90eXBlIGZvciB0aGF0IGNvbnRyYWN0IGFuZCBDdWx0TGliIGdlbmVyYXRvciB3YXMgcGF0Y2hlZCB0byBwcmVzZXJ2ZSBzcGFyc2Uga2V5IHNsb3RzLiIsICJzdGF0dXMiOiAiYWNjZXB0ZWQiLCAidHMiOiAiMjAyNi0wNS0wNlQwMzo1NzoxMCswMDowMCIsICJ0eXBlIjogImFyY2hpdGVjdHVyZSJ9", "stored_at": "2026-05-06T03:57:10.429056+00:00", "type": "ghostlight.evidence_record.v0"}
{"key": "2026-05-06T044920Z0000-0067-d18749ed9b85", "payload": "eyJub3RlIjogIkdob3N0bGlnaHQgYWdlbnQtc3RhdGUgc2NoZW1hIGlzIG5vdyB0aGUgZmlyc3Qgc2hhcmVkIGNyb3NzLXJ1bnRpbWUgcGF5bG9hZCBjb250cmFjdC4gQ3VsdE5ldCBjbGllbnRzIHNob3VsZCBjYXJyeSBnaG9zdGxpZ2h0LmFnZW50X3N0YXRlLnYwIHVuY2hhbmdlZCBpbnNpZGUgdHlwZWQgZG9jdW1lbnQgZW52ZWxvcGVzLCB3aXRoIEN1bHRMaWItc3R5bGUgYXV0aC9zZXNzaW9uIHNlbWFudGljcyBoYW5kbGVkIGJ5IHRoZSB0cmFuc3BvcnQgbGF5ZXIgcmF0aGVyIHRoYW4gYmVzcG9rZSBwZXItcmVwbyBnbHVlLiIsICJzdGF0dXMiOiAiYWNjZXB0ZWQiLCAidHMiOiAiMjAyNi0wNS0wNlQwNDo0OToyMCswMDowMCIsICJ0eXBlIjogImFyY2hpdGVjdHVyZSJ9", "stored_at": "2026-05-06T04:49:20.304695+00:00", "type": "ghostlight.evidence_record.v0"}
{"key": "2026-08-16T142632Z0000-0068-b7da3122b5e8", "payload": "eyJub3RlIjogIkdob3N0bGlnaHREdW5nZW9uIG93bmVyc2hpcCBtYXAgYWNjZXB0ZWQ6IEdob3N0bGlnaHQgb3ducyBnZW5lcmFsaXplZCBQcm9qZWN0b3ItUGVyc29uYS1JbnRlcnByZXRlciBtYWNoaW5lcnk7IGNvbnN1bWluZyBQZXJzb25hcyBzdWNoIGFzIEVwaXBoYW55IHJldGFpbiBjYW5vbmljYWwgbWluZCBhbmQgY29tbWl0IGF1dGhvcml0eSB0aHJvdWdoIG5hcnJvdyBhZGFwdGVycy4gV29ybGRLZXJuZWwgaXMgdGhlIHNvbGUgY2FtcGFpZ24gd3JpdGVyLiIsICJzdGF0dXMiOiAiYWNjZXB0ZWQiLCAidHMiOiAiMjAyNi0wOC0xNlQxNDoyNjozMiswMDowMCIsICJ0eXBlIjogImFyY2hpdGVjdHVyZSJ9", "stored_at": "2026-08-16T14:26:32.332252+00:00", "type": "ghostlight.evidence_record.v0"}

View file

@ -1,7 +1,7 @@
experiment:
name: Ghostlight
status: incubation
phase: phase_0_scaffold
status: active_mvp_build
phase: ghostlight_dungeon_foundation
premise: >
Build a durable research and implementation home for socially persistent
generative agents whose behavior emerges from personality, culture,
@ -9,6 +9,11 @@ experiment:
prompts.
mission:
ghostlight_dungeon: >
Build a persistent, Vault-grounded single-player narrative simulation whose
WorldKernel exclusively owns revisioned world state, while generalized
Projector-Persona-Interpreter machinery produces bounded proposals for the
kernel to validate.
primary: >
Generate psychologically grounded branching scenes, dialogue, actions,
social consequences, and eventually storylines, consumer behavior,
@ -57,6 +62,13 @@ hard_boundaries:
- Visual artifacts are auxiliary illustrated replay and website collateral for the corpus, not core training targets for responder, appraiser, mutator, or relationship models. Visual review judges the playable IF experience and visual plan, not clean-run prose receipts.
live_architecture:
ghostlight_dungeon:
- The authoritative ownership and build map is `docs/architecture/ghostlight-dungeon-mvp.md`.
- One per-campaign WorldKernel mailbox owns canonical state and revision numbers.
- Every player, NPC, institution, scheduler, import, and reload transition uses the same typed WorldCommand validation and atomic CultCache commit path.
- Ghostlight owns generalized Projector to Persona to Interpreter machinery; consuming Personas retain their own canonical minds and commit authority.
- Epiphany will consume the extracted Ghostlight organ through a narrow adapter after her current machinery is mapped into move, stay, split, and delete decisions.
- Existing v0 training fixtures are regression evidence and have no runtime write authority.
persistence_spine:
- Ghostlight is migrating machine-managed persistent state behind `cultcache-py`, linked as `vendor/cultcache-py`.
- `state/ghostlight-state.cultcache.jsonl` is the current CultCache-backed store for migrated branch and evidence records.
@ -242,5 +254,5 @@ data_flow:
- If state grows faster than understanding, cut it back.
current_status:
summary: `corvid-collective-founding-v0` is the newest founding-era draft fixture: a sandboxed coordinator plus sandboxed Interactive Fiction Weaver branch-and-fold pass from Kesh-of-Three-Clicks' embodied raven perspective during the 2470 First Exodus. The Ink compiles, lore grounding validates, click-through visual segmentation now exists, and visual-enabled narrative, lore, spatial, and visual reviewers accepted it as draft after applied fixes. It is reference/draft branch and illustrated replay material, not full responder/appraiser/mutator training data. `lucent-hostage-feed-v0` remains the open-ended training-loop draft with validated initiative scheduling; Pallas remains reference-only, with `pallas-training-loop-v0` as the smaller receipt-chain pilot.
next_action: Choose whether to backfill Corvid/NeuroSyn room-scale lore gaps into AetheriaLore, convert the Corvid fixture into a true scene-loop receipt chain, backfill the useful Lucent lore gaps, or move to the next coverage fixture. Keep broad corpus coverage at draft until artifacts have exact receipts for the organs they claim, and keep meta-coordinator repairs labeled.
summary: GhostlightDungeon is the active MVP program. Its authority map assigns canonical campaign state and revision ownership to a per-campaign WorldKernel mailbox, preserves existing fixtures as regression evidence, and assigns the generalized Projector-Persona-Interpreter organ to Ghostlight while each consuming Persona retains its own canonical mind and commit authority.
next_action: Map Epiphany's current Persona projection implementation in plain language and source references, classify every part as move to Ghostlight, stay in Epiphany, split at a narrow port, or delete, then revise the inert Rust scaffold against that map before continuing implementation.