Files
git.stella-ops.org/src/Timeline
master 4a8e2758cd refactor(timeline): renumber migrations to sequential 002-004 format
Renames date-prefixed migrations (20260107_002, 20260408_003, 20260409_004)
to plain sequential numbers (002, 003, 004) to match the convention used by
other service migration directories. Adds TimelineCoreMigrationCategoryTests
to verify the unified-audit migration registers under the correct category
for the StartupMigrationHost transaction classifier.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 21:56:52 +03:00
..

Timeline

Container(s): stellaops-timeline-web Slot: 24 (timeline) | Port: 8080 | Consumer Group: timeline Resource Tier: light Network aliases: timeline.stella-ops.local, timelineindexer.stella-ops.local (backwards compat)

Purpose

The Timeline module provides a unified, HLC-ordered event timeline across the entire platform. It aggregates audit events from Authority, JobEngine, Policy, Evidence Locker, and Notify via HTTP polling and direct ingestion. It also serves timeline indexer query and evidence linkage endpoints (previously in separate timeline-indexer-web and timeline-indexer-worker containers, now merged).

API Surface

  • /api/v1/audit/* — unified audit aggregation, anomaly detection, export
  • /api/v1/timeline/* — timeline indexer event CRUD, indexed queries, evidence linkage
  • /api/v1/timeline/hlc/* — HLC-ordered event queries, replay, export
  • /timeline/* — bare-prefix indexer endpoints (direct access)

Storage

PostgreSQL schema timeline (via Postgres:Timeline:ConnectionString); Valkey for eventing

Background Workers

  • TimelineIngestionWorker (hosted service) — background event ingestion from NATS/Redis (transports disabled by default)

Merge History

  • Timeline Indexer (Slot 23) was merged into Timeline (Slot 24). The timelineindexer.stella-ops.local network alias is preserved on the timeline-web container for backwards compatibility.