How edwardathomson/storydaemon works
StoryDaemon is a CLI-driven autonomous novel generator. A user creates or resumes a project, then runs story ticks: the agent plans and writes scenes with an LLM, using plot beats when enabled and project memory for continuity. Memory tracks entities, scenes, and searchable context; coherence features guide tension, arcs, threads, and endings. The CLI also exposes inspection, checkpointing, plot controls, and manuscript export. Edges reflect README workflow statements or references visible in the supplied SOURCE INDEX; unsampled modules limit detail on their internal calls.
Main entry points: main.py Novel CLI · agent.py Tick Agent · multi_stage_planner.py Scene Planning · manager.py Story Memory
Components 23
Projects and CLI
- Novel CLI
novel_agent/cli/main.py - Project Setup
novel_agent/cli/project.py - Story Foundation
novel_agent/cli/foundation.py - Configuration
novel_agent/configs/config.py
Story Generation
- Tick Agent
novel_agent/agent/agent.py - Scene Planning
novel_agent/agent/multi_stage_planner.py - Scene Writing
novel_agent/agent/writer.py - Writer Context
novel_agent/agent/writer_context.py - Scene Skeletons
novel_agent/agent/scene_skeleton.py - Plot Beats
novel_agent/plot/manager.py
Memory and Coherence
- Story Memory
novel_agent/memory/manager.py - Story Entities
novel_agent/memory/entities.py - Semantic Search
novel_agent/memory/vector_store.py - Arc and Tension
novel_agent/agent/arc_pressure.py - Narrative Threads
novel_agent/agent/thread_registry.py - Beat Contracts
novel_agent/contracts/authoring.py
LLM and Tools
- LLM Dispatch
novel_agent/tools/llm_interface.py - Agent Tools
novel_agent/tools/registry.py
Inspection and Export
- Project Inspection
novel_agent/cli/commands/inspect.py - Checkpoints
novel_agent/memory/checkpoint.py - Manuscript Export
novel_agent/cli/commands/compile.py - Export Formats
novel_agent/export/chapters.py
Other components
- Writer
Connections 24
- Writer → Novel CLI: runs commands
README.md - Novel CLI → Project Setup: creates or finds
novel_agent/cli/main.py - Novel CLI → Tick Agent: runs ticks
novel_agent/cli/main.py - Project Setup → Story Foundation: collects foundation
novel_agent/cli/project.py - Project Setup → Configuration: reads settings
novel_agent/cli/project.py - Tick Agent → Scene Planning: delegates planning
novel_agent/agent/agent.py - Tick Agent → Scene Writing: delegates writing
novel_agent/agent/agent.py - Tick Agent → Story Memory: uses memory
novel_agent/agent/agent.py - Tick Agent → LLM Dispatch: generates with LLM
novel_agent/cli/main.py - Tick Agent → Agent Tools: uses tool registry
novel_agent/agent/agent.py - Scene Writing → Writer Context: builds prompt context
novel_agent/agent/writer_context.py - Writer Context → Scene Skeletons: samples skeleton
novel_agent/agent/writer_context.py - Writer Context → Arc and Tension: adds arc guidance
novel_agent/agent/writer_context.py - Scene Planning → Plot Beats: uses plot beats
- Plot Beats → Story Memory: reads story state
novel_agent/plot/manager.py - Plot Beats → Beat Contracts: sanitizes conditions
novel_agent/plot/manager.py - Story Memory → Story Entities: loads and saves
novel_agent/memory/manager.py - Story Memory → Semantic Search: semantic retrieval
- Scene Planning → Arc and Tension: applies arc pressure
- Scene Planning → Narrative Threads: uses thread registry
- Novel CLI → Project Inspection: dispatches inspection
novel_agent/cli/main.py - Novel CLI → Checkpoints: checkpoints project
novel_agent/cli/main.py - Novel CLI → Manuscript Export: compiles manuscript
novel_agent/cli/main.py - Manuscript Export → Export Formats: exports chapters
novel_agent/cli/commands/compile.py