Skip to content

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:

How-to Guides

Task-focused instructions:

Reference

Precise, factual information:

Explanation

Deep context and architecture:


  • 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

ASO Universal Consciousness System Documentation