mock-infrastructure-engineer

Novelist.ai is a sophisticated eBook generation platform that leverages

Goal-Oriented Action Planning (GOAP) to orchestrate AI agents in creating

complete novels. Unlike traditional linear AI writing tools, this engine uses

intelligent planning to break down the complex task of novel writing into

discrete, achievable goals with preconditions and effects.

What is GOAP?

GOAP (Goal-Oriented Action Planning) is an AI architecture pattern commonly used

in game development that allows agents to autonomously plan sequences of actions

to achieve goals. In Novelist.ai:

• Agents (Architect, Writer, Editor, Doctor, etc.) have specialized roles
• Actions have preconditions (what must be true) and effects (what changes)
• Planner dynamically selects the optimal action sequence based on current

world state

• World State tracks progress (hasOutline, chaptersCompleted, etc.)

This creates an adaptive, intelligent writing system that can handle complex

multi-chapter projects with consistency and coherence.

---

🤖 **Multi-Agent GOAP System**

• Architect Agent: Generates story outlines using hero's journey structure
• Writer Agents: Parallel chapter drafting with context awareness
• Editor Agent: Consistency checking and plot hole detection
• Doctor Agent: Specialized dialogue polishing and refinement
• Profiler Agent: Character development and psychological profiling
• Builder Agent: World-building, lore, and setting expansion

📚 **Intelligent Content Generation**

• Hierarchical story generation (outline → chapters → content)
• Context-aware chapter writing with previous chapter continuity
• Dynamic content refinement with adjustable temperature and model selection
• Character development and world-building tools
• Plot enhancement and dialogue polishing
• Writing Assistant with real-time style analysis and grammar suggestions
• Multi-provider AI support via OpenRouter SDK (Anthropic, Google, OpenAI, etc.)

🎨 **Rich User Interface**

• Real-time GOAP visualizer showing planning stages
• Agent console with color-coded logging
• Interactive chapter editor with markdown support
• Project dashboard with statistics and progress tracking
• Dark mode support with theme persistence

📦 **Export & Publishing**

• EPUB 3.0 generation with proper metadata
• Cover image generation using Google Imagen
• Chapter illustrations support
• Drop caps and custom styling options
• Multi-language support
• Publishing analytics and platform status tracking

💾 **Data Management**

• Turso (libSQL) database integration with localStorage fallback
• Auto-save functionality (2-second debounce)
• Project versioning and management
• Import/export capabilities
• PWA Support: Installable app with offline capabilities
• Analytics Dashboard: Writing statistics, productivity tracking

---

Comprehensive documentation for all 14 features is available with detailed

guides, examples, and API references:

Core Writing Features

• [Editor](src/features/editor/README.md) - Chapter editing, markdown

support, auto-save, word count tracking

• [Writing Assistant](src/features/writing-assistant/README.md) - Real-time

style analysis, grammar suggestions, readability metrics

• [Undo/Redo System](src/features/editor/hooks/useUndoRedo.ts) - 50-action

history with Ctrl+Z (undo) and Ctrl+Y (redo) shortcuts, toolbar integration

• [Generation](src/features/generation/README.md) - GOAP engine, AI content

generation, multi-agent orchestration

Content Management

• [Projects](src/features/projects/README.md) - Project creation,

management, import/export, wizard interface

• [Characters](src/features/characters/README.md) - Character profiles,

psychological traits, relationships

• [World Building](src/features/world-building/README.md) - Locations,

cultures, history, magic systems

• [Timeline](src/features/timeline/README.md) - Event tracking, eras,

chronological visualization

User Experience

• [Help/Documentation Center](src/features/help/README.md) - 8 categories

with 18+ articles, full-text search, keyboard shortcut (Ctrl+/), real-time

filtering

• [Inline Form Validation](src/shared/components/forms/FormField.tsx) -

Real-time validation for all major forms (projects, characters, chapters,

settings), WCAG AA compliant error display

• [Settings](src/features/settings/README.md) - Theme management, AI

configuration, RAG settings, editor preferences

• [Onboarding Flow](src/features/onboarding/README.md) - Multi-step guided

tour for new users

• [Mobile Navigation](src/shared/components/layout/BottomNav.tsx) - Bottom

navigation with More sheet for additional views, touch-optimized targets

AI & Analysis

• [Plot Engine](src/features/plot-engine/README.md) - Story structure,

hero's journey, plot points, consistency checking

• [Semantic Search](src/features/semantic-search/README.md) - Vector

embeddings, similarity search, context retrieval

• [Analytics](src/features/analytics/README.md) - Writing sessions,

productivity insights, goals tracking

Publishing

• [Publishing](src/features/publishing/README.md) - EPUB/PDF/MOBI export,

platform integrations, metadata management

Gamification

• [Gamification](src/features/gamification/README.md) - XP system,

achievements, streaks, badges, leveling

Version Control

• [Versioning](src/features/versioning/README.md) - Version control,

branching, diff comparison, content hashing

User Experience

• [Help/Documentation Center](src/features/help/README.md) - Comprehensive

help system with 8 categories, 18+ articles, full-text search, keyboard

shortcut (Ctrl+/), related articles, WCAG AA compliant

• [Settings](src/features/settings/README.md) - Theme management, AI

configuration, RAG settings, editor preferences

• [Onboarding Flow](src/features/onboarding/README.md) - Guided walkthrough

for new users with 5-step process

• [Mobile Navigation](src/shared/components/layout/BottomNav.tsx) - Bottom

navigation bar with More sheet for additional views, 44×44 touch targets

• [Gamification](src/features/gamification/README.md) - XP system,

achievements, streaks, badges, leveling

• [Versioning](src/features/versioning/README.md) - Version control,

branching, diff comparison, content hashing

Documentation Quality: 90% (A-) | Coverage: 100% (14/14 features)

---

Technology Stack

```

Frontend:

├── React 19.2 # UI framework

├── TypeScript 5.8 # Type safety

├── Vite 6.2 # Build tool & dev server

├── Tailwind CSS # Utility-first styling

└── Lucide React # Icon library

AI & Services:

├── OpenRouter SDK # Multi-provider AI (Anthropic, Google, OpenAI, etc.)

├── Google Imagen # Cover & illustration generation

└── @libsql/client # Turso database client

Utilities:

├── JSZ