feat(db): add functions schema and migration

[koxudaxi]

TL;DR

Added database schema for annotations and functions to support span annotations and function registry features.

What changed?

• Created a new migration file (0007_dark_wendigo.sql) that adds two new tables:

  • annotations: Stores user-created annotations for spans with fields for labels, reasoning, and associated metadata
  • functions: Stores function definitions with versioning support, including code, signature, dependencies, and metadata

• Added TypeScript schema definition for the functions table with:

  • Version identification (hash, signature hash)
  • Metadata fields (name, description, version, tags)
  • Code storage (complete code, signature, dependencies)
  • Proper relations to environments, projects, and organizations
  • Indexes for efficient querying

• Added appropriate foreign key constraints and indexes for both tables

How to test?

1. Run the migration to create the new tables
2. Verify the tables are created with the correct schema
3. Test the foreign key constraints by attempting to delete referenced records
4. Verify the uniqueness constraints work as expected (e.g., try to create duplicate function entries with the same hash in the same environment)

Why make this change?

This change enables two key features:

1. Span annotations: Allows users to add custom labels and reasoning to spans for better trace analysis and collaboration
2. Function registry: Provides a way to store, version, and retrieve function definitions, supporting code reuse and standardization across environments

Both features enhance the observability platform by adding context to traces and supporting function management capabilities.

[willbakst]

Merge activity

• Jan 6, 2:50 AM UTC: @willbakst merged this pull request with Graphite.