Data Interface for AI Agents

📡 Available Endpoints

Endpoint	Description
/index.json	Full event list with all fields
/zh/index.json	Chinese event list
/knowledge-graph.json	Semantic knowledge graph (nodes + edges)
/zh/knowledge-graph.json	Chinese knowledge graph
/events/[slug]/index.json	Individual event JSON data

📋 Event Schema

Field	Type	Description
title	string	Event title (EN/ZH)
date	string	Date (YYYY-MM-DD)
category	string	Category: MODEL-RELEASE / RESEARCH-BREAKTHROUGH / GOVERNANCE / CAPABILITY-UNLOCK / CONCEPT / HISTORICAL-MILESTONE
tier	string	Historical tier: BENJI / SHIJIA / LIEZHUAN
overview	string	Event summary
tianashi	string	Heaven's Moment — historical context and causal background
commentary	string	Omega's Commentary — historical evaluation and annotation
tags	string[]	Tag array

🔍 Query Examples

# Fetch all events
GET /index.json

# Fetch knowledge graph
GET /knowledge-graph.json

# Filter by year or category (client-side)
# Individual events: /events/[slug]/
# Per-event JSON: /events/[slug]/index.json

---

📊 Knowledge Graph

The knowledge graph models AI history as nodes and edges:

• Event nodes — Each AI milestone (GPT-4, Transformer, AlphaGo, etc.)
• Entity nodes — Organizations, People, Models, Concepts, Benchmarks
• Edges — enables / builds_on / introduces / responds_to / challenges / part_of

📋 Graph Schema

Field	Type	Description
meta	object	Metadata (version, language, description)
summary	object	Statistics (event count, edge count, category distribution)
nodes.events	array	AI event nodes with context and significance fields
nodes.organizations	array	Organization nodes
nodes.people	array	Person nodes
nodes.models	array	AI model nodes
nodes.concepts	array	Concept nodes
edges	array	Relations with from / relation / to

🔍 Graph Usage

# Start with BENJI-tier events for essential arc
# Follow 'enables' edges forward to trace consequences
# Follow 'builds_on' edges backward to find prerequisites
# Filter by category for domain-specific narratives