154 lines
7.5 KiB
Markdown
154 lines
7.5 KiB
Markdown
# Ghostlight Current System Map
|
|
|
|
Ghostlight does not have a runtime yet. The live system right now is the repo's
|
|
state and re-entry discipline.
|
|
|
|
## Current Control Flow
|
|
|
|
1. A user or agent enters the repo with a bounded question or implementation
|
|
goal.
|
|
2. The session rehydrates from:
|
|
- `state/map.yaml`
|
|
- `notes/fresh-workspace-handoff.md`
|
|
- this file
|
|
- `notes/ghostlight-implementation-plan.md`
|
|
3. The session runs `npm run state:status` to recover the current summary, next
|
|
action, and active subgoals.
|
|
4. Work happens in one bounded slice.
|
|
5. If understanding changes, the map is updated.
|
|
6. If future belief changes, distilled evidence is appended.
|
|
7. If compaction pressure rises, the helper audits state hygiene before the
|
|
session banks the fire.
|
|
|
|
## Live Surfaces
|
|
|
|
- `state/map.yaml`
|
|
- canonical experiment, objective, constraints, invariants, active subgoals,
|
|
accepted design, and current status
|
|
- `state/scratch.md`
|
|
- temporary working memory for one bounded organ
|
|
- `state/evidence.jsonl`
|
|
- durable belief-changing records only
|
|
- `state/branches.json`
|
|
- explicit hypothesis or branch tracking
|
|
- `notes/fresh-workspace-handoff.md`
|
|
- re-entry packet
|
|
- `notes/ghostlight-implementation-plan.md`
|
|
- larger-organ sequence
|
|
- `docs/research/`
|
|
- research backlog and social-model notes
|
|
- `docs/architecture/`
|
|
- world, state, and prompt-system architecture notes
|
|
- `docs/architecture/prompt-projection-contract.md`
|
|
- contract for turning durable state into speaker-local pressure prose and
|
|
prompt sections
|
|
- `docs/architecture/projection-distillation-plan.md`
|
|
- plan for using a frontier teacher model to generate reviewed projection
|
|
artifacts before training a smaller student projector
|
|
- `docs/architecture/sequential-agent-runtime.md`
|
|
- scene-local dialogue/runtime loop where agents act from local awareness,
|
|
generated actions become event proposals, and bounded state mutation drives
|
|
branchable speech or non-speech scene consequences while preserving
|
|
training hooks for later open-world, economic, and faction decision models
|
|
- `docs/architecture/ink-branching-scenes.md`
|
|
- integration contract that makes Ink the standard playable branch format
|
|
while Ghostlight owns local awareness, projection rationale, consequence
|
|
review, and state mutation around Ink scenes
|
|
- `docs/experiments/cold-wake-story-lab.md`
|
|
- four-scene Cold Wake writing experiment using Ghostlight projection as a
|
|
story-generation crutch and training-data source
|
|
- `docs/architecture/schema-future-mechanisms.md`
|
|
- parking lot for appraisal, transition, belief, action, conversation,
|
|
resource, dyad, institution, memory, and embodiment mechanisms not yet
|
|
promoted into the v0 schema
|
|
- `docs/architecture/aetheria-lore-grounding-architecture.md`
|
|
- boundary and plan for grounding training data in authored Aetheria history
|
|
while treating Elysium gameplay-era outcomes as procedural branch space
|
|
- `docs/architecture/lore-grounding-digest-format.md`
|
|
- human-facing format guide for cultural, factional, institutional, role, and
|
|
speaker-boundary lore digests
|
|
- `docs/architecture/aetheria-cold-wake-training-fixture.md`
|
|
- human-facing note that reframes the recovered Cold Wake scenario as
|
|
historical projection feedstock rather than the active product target
|
|
- `schemas/agent-state.schema.json`
|
|
- v0 canonical agent-state contract for agents, relationships, events,
|
|
scenes, perceived overlays, and dialogue context packs
|
|
- `schemas/projection-example.schema.json`
|
|
- v0 reviewed projection artifact contract for speaker-local prompt
|
|
projection examples, including projection controls for frame, authority,
|
|
object custody, required semantics, and forbidden resolutions
|
|
- `schemas/lore-grounding-digest.schema.json`
|
|
- v0 contract for grounding historical fixtures in source-backed cultural and
|
|
factional pressure fields
|
|
- `schemas/agent-state.required-fields.json`
|
|
- required first-class variable names for canonical state and relationship
|
|
stance
|
|
- `examples/agent-state.call-of-the-void.json`
|
|
- first Call of the Void-flavored fixture for schema and projection work
|
|
- `examples/agent-state.cold-wake-story-lab.json`
|
|
- first story-shaped historical fixture for Cold Wake projection work
|
|
- `examples/projections/call-of-the-void.scene-broken-taxi-oz.jsonl`
|
|
- first reviewed Cat and Oz projection examples
|
|
- `examples/projections/call-of-the-void.scene-broken-taxi-oz.pretty.json`
|
|
- pretty-printed mirror for inspecting the first projection examples
|
|
- `examples/projections/cold-wake-story-lab.jsonl`
|
|
- response-turn projection examples for the Cold Wake story lab, including
|
|
rejected and accepted Maer/Veyr prompt revisions
|
|
- `experiments/cold-wake-story-lab/`
|
|
- Qwen response captures and reviews from the writing experiment
|
|
- `the-narrowest-possible-margin.md`, the first readable short story
|
|
assembled from accepted projection outputs
|
|
- `examples/lore-grounding/historical-flashpoint.template.json`
|
|
- fillable template for the first historical Aetheria grounding digest
|
|
- `examples/lore-grounding/cold-wake-panic.ganymede-corridor.json`
|
|
- first draft historical grounding digest, centered on Cold Wake Panic in the
|
|
Ganymede/Jovian corridor
|
|
- `examples/ink/cold-wake-sanctuary-intake.ink`
|
|
- first playable Ink-backed Cold Wake branching scene, using speech, gesture,
|
|
object revelation, and moral-pressure branches
|
|
- `examples/ink/cold-wake-sanctuary-intake.training.json`
|
|
- reviewed sidecar annotation tying Ink branches to Ghostlight local
|
|
awareness, projection controls, branch rationale, consequence surfaces, and
|
|
manual mutation policy
|
|
- `tools/ghostlight_state.py`
|
|
- compact state inspection and evidence or branch updates
|
|
- `tools/ghostlight_prepare_compaction.py`
|
|
- pre-compaction audit of required files, handoff content, and git hygiene
|
|
- `tools/validate_agent_state.py`
|
|
- dependency-free validator for the current schema fixture invariants
|
|
- `tools/validate_projection_examples.py`
|
|
- dependency-free validator for projection example JSONL records
|
|
- `tools/run_qwen_projection.py`
|
|
- sends a projection prompt to the LAN Qwen box and saves response/capture
|
|
artifacts without PowerShell encoding footguns
|
|
- `tools/validate_qwen_captures.py`
|
|
- validates reviewed Qwen response capture receipts
|
|
- `tools/validate_lore_grounding.py`
|
|
- dependency-free validator for lore grounding digest examples
|
|
- `tools/validate_ink_examples.py`
|
|
- compiles Ink examples with `inkjs` and validates sidecar training
|
|
annotations
|
|
- `tools/build_cold_wake_story_lab_fixture.py`
|
|
- generator for the verbose Cold Wake story-lab state fixture
|
|
|
|
## What Does Not Exist Yet
|
|
|
|
- a classifier pipeline
|
|
- a prompt renderer
|
|
- a full projection training corpus
|
|
- a deterministic projection input slicer
|
|
- a student projection model
|
|
- a simulation/event loop implementation
|
|
- a relationship engine
|
|
- a culture prior engine
|
|
- an automatic Ink branch generator from local awareness
|
|
- automatic promotion of Ink branch outcomes into canonical state
|
|
|
|
The canonical agent-state schema, projection example schema, lore grounding
|
|
digest schema, first draft Cold Wake grounding digest, and first Cold Wake
|
|
story-lab Qwen captures now exist as v0 seams. The first complete Cold Wake
|
|
story pass exists with receipts, and projection controls have been promoted as
|
|
the architectural answer to repeated prompt leaks. Ink is now the standard
|
|
branching scene format; the next implementation target is projecting or
|
|
generating Ink branches from local awareness and testing selected branch
|
|
mutation through reviewed state, memory, and relationship updates.
|