feat(db): add annotations schema

[koxudaxi]

TL;DR

Added database schema for annotations to enable span and trace labeling functionality.

What changed?

Created a new annotations.ts file in the cloud database schema that defines:

• An annotations table with fields for:
  • Identifiers (id, spanDbId, traceDbId, spanId, traceId)
  • Content (label, reasoning, data)
  • Scope (environmentId, projectId, organizationId)
  • Audit fields (createdBy, createdAt, updatedAt)
• Unique constraints to ensure one annotation per span+trace+environment
• Indexes for efficient querying by trace and environment
• Relation definitions connecting annotations to spans, traces, environments, projects, organizations, and users
• TypeScript types for internal and public API use

How to test?

1. Run database migrations to create the new annotations table
2. Verify the table structure matches the schema definition
3. Test creating annotations with various combinations of span/trace IDs
4. Confirm unique constraints prevent duplicate annotations
5. Test querying annotations using the defined indexes

Why make this change?

This schema enables a new annotations system that allows users to label spans and traces (e.g., as "pass" or "fail") with additional reasoning and structured data. This functionality is essential for:

1. Quality assessment of traces and spans
2. Creating training data for ML models
3. Enabling team collaboration through shared annotations
4. Supporting audit trails of trace analysis

[graphite-app]

Merge activity

• Jan 6, 3:06 AM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.
• Jan 6, 3:17 AM UTC: @willbakst merged this pull request with Graphite.