TimeLoop: The Unspeakable Midnight

Quick Start

Architecture

• NLU + NLG: Single LLM API call (GPT-4o-mini) with structured JSON output handles intent recognition, narrative generation, and state update suggestions simultaneously.
• State Engine: Structured GameState (per-loop) + LoopMemory (persistent across loops) + SanitySystem (maps sanity value to narrative style).
• Consistency Checker: Hard rules (deterministic Python checks) + soft check (sentence-transformers semantic similarity).
• UI: Gradio with narrative panel, status bar, choice buttons, and collapsible debug panel.

Project Structure

config/          -- Settings, prompt templates, NPC profiles
data/            -- World data, NPC data, plot graph, consistency rules
src/llm/         -- LLM API client, prompt builder, output parser
src/state/       -- Game state, loop memory, sanity system
src/consistency/  -- Hard rules checker, semantic soft checker
src/game/        -- Game engine, loop manager
src/ui/          -- Gradio application
logs/            -- Game trajectory logs (auto-generated)