Skip to content

content(timeline): grow world events dataset from 24 to ~120 #1813

@CraigBuckmaster

Description

@CraigBuckmaster

Parent epic: #1808
Depends on: #1810, #1811, #1812

Goal

Grow the world events dataset from 24 to ~120 entries, distributed across the 17 eras. AI-generated, accuracy-audited per the established editorial standard.

Depends on

  • Schema extension issue (must land first)
  • Card display polish issue (so new entries with certainty markers render correctly)
  • Accuracy auditor extension (so new entries are validated as they land)

Editorial standard

  • 1–2 sentence summaries
  • Factual, neutral tone
  • No theological framing — these are context, not exegesis
  • Each entry includes region (canonical), year, date_certainty, optional related_biblical_event_ids

Target distribution

Era Span Target Notes
primeval -4000..-2200 5 early civilizations, writing, bronze working
patriarch -2200..-1800 6
exodus -1800..-1400 8 Hyksos, New Kingdom Egypt, Mycenaean Greece
judges -1400..-1050 10 Bronze Age collapse, Sea Peoples, Phoenicians
kingdom -1050..-930 6
divided_kingdom -930..-722 10 Assyrian rise, early Greek polis
prophets -930..-586 10 overlaps allowed; tag with primary era
exile -586..-538 6 Babylonian zenith, Persian rise
post-exilic -538..-432 10 Greco-Persian Wars, Athens classical age
intertestamental -432..-4 20 Alexander, Diadochi, Roman Republic, Maccabees
nt / life_of_christ -4..30 8 Augustus → Tiberius, Roman Judea governors
early_church 30..46 4 Caligula, Claudius, AD 49 expulsion
pauline_mission 46..67 8 Nero, fire of Rome, AD 66 revolt
general_epistles / apocalyptic 45..96 5 Vespasian, Titus, Flavians, Domitian
Total ~116

Workflow

Split into 4 sub-batches, one PR per batch:

  • 4a: primeval through judges (~30 entries) → feat/world-events-batch-1-primeval-judges
  • 4b: kingdom through exile (~32 entries) → feat/world-events-batch-2-kingdom-exile
  • 4c: post-exilic through intertestamental (~30 entries) → feat/world-events-batch-3-postexilic-intertestamental
  • 4d: NT era (~25 entries) → feat/world-events-batch-4-nt-era

Each PR:

  1. Generator script in /tmp/ writes new entries directly into content/meta/timelines.json::world_events[]
  2. python3 _tools/schema_validator.py
  3. python3 _tools/build_sqlite.py
  4. python3 _tools/validate_sqlite.py
  5. python3 _tools/accuracy_auditor.py (must pass — new tier covers world events)
  6. Generator deleted
  7. PR with the standard deploy checklist

Acceptance criteria (per sub-batch)

  • All new entries pass schema validator
  • All new entries pass accuracy auditor (no date drift, no theological language, no broken refs)
  • Region distribution is reasonable (no single region dominates)
  • At least 50% of new entries include 1+ related_biblical_event_ids (where defensible)
  • CI green; PR merged to master

Out of scope

  • Images on world events
  • Cross-region narrative arcs / multi-event story threads
  • Parallel-lane visualization (separate epic if pursued)
  • World religions / philosophical movements (separate concept card)

Branch / commit hygiene

One branch per sub-batch. Commit prefix: content(timeline):. Each batch is its own PR for clean review and rollback.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions