The ClockWork Dark

The world is no longer static scenery — it reacts.

unmake

reckoning at the tower. The narrative spine is complete: tunnels open → descend → Hollow Hill → name the Hollow Crown → carry the older name → unmake the Dark.:focus-visible

; prefers-reduced-motion

.A deterministic engine holds all mechanical truth; two autonomous LLM agents improvise on top; a governance layer reins them in; OKFS feeds them canon; media renders it.

flowchart TB
    subgraph HARD["Hard Engine — engine/game/ (the only authority)"]
        STATE["GameState · dice · combat · crafting · travel<br/>evil_ticker · DoomClock · challenges · contracts"]
        SKILLS["@skill registry — engine/skills/<br/>roll_dice · resolve_combat · craft_item · move_to · confront_darkness"]
    end
    subgraph AGENTS["Two Agents — engine/agents/"]
        DRIVER["Storyteller / Driver<br/>big model · drives world · Evaluator gate + retry"]
        ASSIST["Assistant<br/>small model · unreliable companion<br/>AssistantDirector: when / with-what / how-reliably"]
    end
    subgraph GOV["Governance — engine/governance/ + engine/mcp/"]
        PRE["PRE interceptors — shape the prompt<br/>LoreInject · DoomBeat · EvilPhaseTone · StorytellerMind · AwarenessGate"]
        POST["POST audit — SceneRulesEngine R001-R005<br/>RulesGovernor records LLM overreach"]
    end
    subgraph KNOW["OKFS Knowledge — knowledge/"]
        OKFS["one concept per .md + frontmatter + links<br/>lore · NPCs · items · arcs · runbooks · metrics<br/>content-hashed _index.json"]
    end
    subgraph MEDIA["Media — engine/media/ (graceful degradation)"]
        IMG["ComfyUI images / cutscenes"]
        VOICE["Voxtral TTS / STT"]
    end
    OBS["Oracle — engine/observability/ · /api/metrics"]

    SKILLS <--> STATE
    AGENTS -- "propose, never decide" --> SKILLS
    PRE --> AGENTS --> POST
    KNOW -. "RAG / progressive disclosure" .-> AGENTS
    AGENTS --> MEDIA
    AGENTS --> OBS
    POST --> OBS

The balance we chase: let the AIs run loose enough to surprise; rein them with the engine + governance enough to stay coherent and fair.