feat(Feature Lifecycle): Update API with feature lifecycle info

[emyller]

• 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 #7433

1. Introduces a new endpoint (also to MCP) /api/v1/environments/{environment}/feature-lifecycle-counts/

   {
     "NEW": 475,
     "LIVE": 734,
     "PERMANENT": 190,
     "STALE": 374,
     "NEEDS_MONITORING": 30,
     "TO_REMOVE": 197
   }

2. Adds new query params to the existing GET /api/v1/projects/{project_pk}/features/ (list):
   • lifecycle_stage: one of stages below; requires environment.
3. Adds a new attribute lifecycle_stage to the above list endpoint, and also to .../{feature_id} (retrieve), also carrying one of stages below.

Stages logical propositions are as follows:

State	Condition
PERMANENT	has_permanent_tag
LIVE	~has_permanent_tag AND ~has_stale_tag AND has_code_references
NEW	~has_permanent_tag AND ~has_stale_tag AND ~has_code_references
STALE	~has_permanent_tag AND has_stale_tag AND has_code_references
NEEDS_MONITORING	~has_permanent_tag AND has_stale_tag AND ~has_code_references AND evaluated_recently
TO_REMOVE	~has_permanent_tag AND has_stale_tag AND ~has_code_references AND ~evaluated_recently

How did you test this code?

• New tests

Note

If you've read thus far, here's a pro-tip! :chest:
Reviewing is easier if you split: (comments go to PR, not commits)

• Part 1: InfluxDB API refactor (to enable tests) — it revealed we need to rewrite it, or maybe invest in something else.
• Part 2: Feature Lifecycle stage counts API (to feed the count badges in the sidebar.
• Part 3: Extend the feature list and retrieve endpoints with lifecycle stage information.
• Part 4: Add filter by lifecycle stage capability to the feature list endpoint.

[vercel]

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

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs	Ignored	Preview	Jun 22, 2026 9:28pm
flagsmith-frontend-preview	Ignored	Preview	Jun 22, 2026 9:28pm
flagsmith-frontend-staging	Ignored	Preview	Jun 22, 2026 9:28pm

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.60%. Comparing base (d991940) to head (6b7c8d5).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff            @@
##             main    #7789    +/-   ##
========================================
  Coverage   98.59%   98.60%            
========================================
  Files        1472     1480     +8     
  Lines       57370    57750   +380     
========================================
+ Hits        56564    56944   +380     
  Misses        806      806            

☔ View full report in Codecov by Harness.
📢 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.

[github-actions]

Docker builds report

Image	Build Status	Security report
ghcr.io/flagsmith/flagsmith-e2e:pr-7789	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-api-test:pr-7789	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-frontend:pr-7789	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith:pr-7789	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith-private-cloud:pr-7789	Finished ✅	Results ✅

[github-actions]

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

 2 passed

Details

 2 tests across 2 suites
 32.5 seconds
 76de9b7
 🔄 Run: #17696 (attempt 1)

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

 1 passed

Details

 1 test across 1 suite
 43 seconds
 76de9b7
 🔄 Run: #17696 (attempt 1)

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

 4 passed

Details

 4 tests across 4 suites
 34.4 seconds
 76de9b7
 🔄 Run: #17696 (attempt 1)

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

 1 passed

Details

 1 test across 1 suite
 1 minute, 7 seconds
 76de9b7
 🔄 Run: #17696 (attempt 1)

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

 21 passed

Details

 21 tests across 16 suites
 1 minute, 20 seconds
 6b7c8d5
 🔄 Run: #17727 (attempt 1)

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

 1 passed

Details

 1 test across 1 suite
 44.3 seconds
 6b7c8d5
 🔄 Run: #17727 (attempt 1)

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

 1 passed

Details

 1 test across 1 suite
 41.3 seconds
 6b7c8d5
 🔄 Run: #17727 (attempt 1)

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

 1 passed

Details

 1 test across 1 suite
 56.1 seconds
 6b7c8d5
 🔄 Run: #17727 (attempt 1)

[github-actions]

Visual Regression

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