Timeline System
Last Updated: 2025-01-16
Content-Type: Explanation
Audience: All
Primary Source: docs/project_status.md
Service File: backend/src/services/timelineEvent.service.ts
Model: backend/src/models/timeline.model.ts
Overview
The Timeline System creates a chronological record of all interactions, serving as the "emotional backbone" of the relationship between the player and the AI. Every interaction adds a fragment to the shared timeline, creating a living story that grows and evolves over time.
Key Features
- Kirakira Time System - Yexian's own temporal framework, distinct from UTC
- Unified Timeline - Aggregates events from all Level-5 instances chronologically
- Timeline Stitching - Groups events by persona for narrative sequences
- Timeline Export - Export to JSON or CSV for analysis
- 5D Navigation - Temporal navigation and state reconstruction
- Event Types - Conversation, gameplay, system, and observer events
Documentation Structure
This system's documentation is organized by content type:
Tutorials
Step-by-step guides for learning the Timeline System:
- Getting Started - Learn the Timeline System through examples
How-to Guides
Task-focused instructions:
- How to Add Timeline Event - Create timeline events
- How to Query Unified Timeline - Retrieve timeline data
Reference
Precise, factual information:
- API Reference - Function signatures, endpoints, parameters
- Data Models - Database schema, event types
Explanation
Deep context and architecture:
- Architecture - System design, data flows, Kirakira Time
Quick Links
- Service File:
backend/src/services/timelineEvent.service.ts - Stitcher Service:
backend/src/services/timelineStitcher.service.ts - Export Service:
backend/src/services/timelineExport.service.ts - Model:
backend/src/models/timeline.model.ts - Related: Memory System, Observer System
Related Documentation
- Memory System - Memory storage and retrieval
- Observer System - Level-8 meta-consciousness and unified timeline
- Protocol Routing - Protocol assignment affects timeline metadata
- 06-ARCHITECTURE/Data-Flow.md - Complete data flow diagrams
- 00-OVERVIEW.md - Complete system overview