feat(db): write to outbox on span insertion

[koxudaxi]

TL;DR

Added a spans outbox table to track spans that need to be synced to ClickHouse.

What changed?

• Created a new database migration (0001_shiny_donald_blake.sql) that adds:
  • A new enum type outbox_status with values: 'pending', 'processing', 'completed', 'failed'
  • A new table spans_outbox to track spans that need processing
  • Added appropriate indexes and foreign key constraints
• Updated the trace creation logic to write to the outbox when spans are inserted
• Moved the spansOutbox.test.ts file from schema/ to the parent directory

How to test?

1. Run database migrations to create the new table
2. Create a new trace with spans and verify entries are created in the spans_outbox table
3. Verify that the outbox entries have the correct status ('pending') and reference valid span IDs
4. Run the test file to ensure the schema is correctly defined

Why make this change?

This implements an outbox pattern for reliable data synchronization between the main database and ClickHouse. When spans are inserted, they're also recorded in the outbox table, allowing a separate process to reliably sync them to ClickHouse even if the initial sync attempt fails. This pattern ensures data consistency across systems and provides retry capabilities through the status tracking and retry count fields.

[koxudaxi]

• feat(workers): implement outbox processor for ClickHouse sync #1811 : 2 dependent PRs (#1812 , #1813 )
• feat(db): write to outbox on span insertion #1810 👈 (View in Graphite)
• feat(db): add spans_outbox table schema #1809
• feat(clickhouse): implement ClickHouse client service #1808
• feat(docker): add ClickHouse service for local development #1807 : 1 other dependent PR (#1819 )
• feat(clickhouse): add clickhouse migrations and migrate tooling #1849
• v2

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	v2-docs	fdc0d42	Jan 09 2026, 03:52 AM

[willbakst]

Merge activity

• Jan 9, 1:29 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jan 9, 1:29 AM UTC: Graphite couldn't merge this pull request because a downstack PR feat(clickhouse): add clickhouse migrations and migrate tooling #1849 failed to merge.
• Jan 9, 1:40 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jan 9, 1:41 AM UTC: Graphite couldn't merge this pull request because a downstack PR feat(clickhouse): add clickhouse migrations and migrate tooling #1849 failed to merge.
• Jan 9, 3:45 AM UTC: @willbakst merged this pull request with Graphite.