[tylerjroach]

Adds hierarchical groups (HG) support: a MixpanelIdentity carrying user and company ids, HG-aware profile updates, and company-bound group writes. HG behavior is gated on the SDK's hierarchical groups init flag; projects without it behave as before.

Draft, opened for an early automated review. Not ready to merge.

Commits

• feat(analytics): hierarchical groups support
• feat(analytics): refuse alias on hierarchical groups projects
• feat(analytics): refuse merge on hierarchical groups projects
• feat(flags): resolve local assignment keys from context_value_template
• feat(analytics): raise for unsupported group_update operations on hierarchical groups projects
• feat(analytics): add company_* profile methods to for_company clients
• chore(analytics): point the company-only identity error at the company profile API
• revert(analytics): drop the company profile methods from for_company clients
• feat(analytics): infer the company for $company_id group profile updates
• feat(analytics): restore the company profile on for_company clients
• feat(flags): build a flag context from a MixpanelIdentity
• feat(analytics): refuse a user from another company on a for_company client
• feat(analytics): send a user without a company as given on hierarchical groups
• Document MixpanelIdentity on every people method that accepts one

🤖 Generated with Claude Code

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The reviewed changes appear safe to merge; the previous wrong-profile issue is fixed.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Profile update] --> B{Hierarchical groups enabled?}
    B -->|No| C[Send to /engage]
    B -->|Yes| D[Read company and user]
    D --> E{Profile fields agree?}
    E -->|No| F[Raise ValueError; send nothing]
    E -->|Yes| G[Send user group update to /groups]

Loading

_{Reviews (6) · Last reviewed commit: "fix: refuse people_update profile keys t..." · Reviewed by Greptile}

[codecov]

Codecov Report

❌ Patch coverage is 99.71950% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 98.08%. Comparing base (091b056) to head (7ba9c31).

Files with missing lines	Patch %	Lines
mixpanel/__init__.py	98.80%	1 Missing and 1 partial ⚠️
mixpanel/flags/local_feature_flags.py	96.15%	0 Missing and 1 partial ⚠️
mixpanel/flags/test_remote_feature_flags.py	98.73%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #201      +/-   ##
==========================================
+ Coverage   96.39%   98.08%   +1.68%     
==========================================
  Files          15       17       +2     
  Lines        2888     4287    +1399     
  Branches      176      255      +79     
==========================================
+ Hits         2784     4205    +1421     
+ Misses         67       45      -22     
  Partials       37       37              

Flag	Coverage Δ
openfeature-provider	46.96% <20.51%> (-4.29%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.