fix(Code References): Code references are slow to query

[emyller]

Thanks for submitting a PR! Please check the boxes below:

• I have read the Contributing Guide.
• I have added information to docs/ if required so people know about the feature.
• I have filled in the "Changes" section below.
• I have filled in the "How did you test this code" section below.

Changes

Closes #5932
Would originally close #6832

Improve code references so they're usable again.

The previous data model did not handle accumulated code references too well, and we had to disable it.

This patch will:

• Complete redesign the data model of code references.
• Migrate old data to new data.
• Make code references viable for GA: in an hypothetical project with 400 features, 200K code references scans, list annotation improved from ~21s to ~12ms (around 1700x increase), and detail query improved from ~77ms to 1.4ms (~55x). Gotta go fast.
• Prevent duplicate scans — for hygiene: performance gain does not rely on this.
• Add a new "vcs_provider" to the API — but defaults to "github" for compatibility. This will allow support other VCS endeavours for free.
• Delete code_references_ui_stats feature flag branches, 🎉.

How did you test this code?

• Unit tests.
• Benchmarking — tested on Apple silicon.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs	Ignored	Preview	May 12, 2026 1:07am
flagsmith-frontend-preview	Ignored	Preview	May 12, 2026 1:07am
flagsmith-frontend-staging	Ignored	Preview	May 12, 2026 1:07am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.45%. Comparing base (e4651d1) to head (2b0f99e).
⚠️ Report is 17 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff            @@
##             main    #7463    +/-   ##
========================================
  Coverage   98.44%   98.45%            
========================================
  Files        1398     1401     +3     
  Lines       52654    52937   +283     
========================================
+ Hits        51834    52117   +283     
  Misses        820      820            

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

_{Tip: disable this comment in your organization's Code Review settings.}

[github-actions]

Docker builds report

Image	Build Status	Security report

[github-actions]

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 37.3 seconds
 2b0f99e
 🔄 Run: #16672 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 44.5 seconds
 2b0f99e
 🔄 Run: #16672 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 18 passed

Details

 18 tests across 14 suites
 1 minute, 10 seconds
 2b0f99e
 🔄 Run: #16672 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 29.7 seconds
 2b0f99e
 🔄 Run: #16672 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 32.1 seconds
 d087401
 🔄 Run: #16673 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 1 passed

Details

 1 test across 1 suite
 43.1 seconds
 d087401
 🔄 Run: #16673 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 42.1 seconds
 d087401
 🔄 Run: #16673 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 48.9 seconds
 d087401
 🔄 Run: #16673 (attempt 1)

[github-actions]

Visual Regression

16 screenshots compared. See report for details.
View full report