Skip to content

docs: add entitlement tier boundaries proposal#2144

Open
ravverma wants to merge 3 commits intomainfrom
docs/tier-boundaries-proposal
Open

docs: add entitlement tier boundaries proposal#2144
ravverma wants to merge 3 commits intomainfrom
docs/tier-boundaries-proposal

Conversation

@ravverma
Copy link
Copy Markdown
Contributor

@ravverma ravverma commented Apr 7, 2026

Summary

  • Adds docs/tier_boundaries_proposal.md — a design proposal defining clear, non-overlapping capability boundaries for all four entitlement tiers: PRE_ONBOARD, PLG, FREE_TRIAL, and PAID
  • Focuses on the PLG vs FREE_TRIAL gap: both are customer-visible and revocable, but without explicit boundaries they become two names for the same thing
  • Proposes the key differentiators that make PLG distinct:
    • isSummitPlgEnabled = true (PLG-specific summit UX) — via a transitional shim scheduled for removal: getIsSummitPlgEnabled() in utils.js is a temporary compatibility function equivalent to entitlement.getTier() === Entitlement.TIERS.PLG; once PLG is live, all callers should migrate to a direct tier check and the function deleted
    • No TrialUser lifecycle tracking (different acquisition motion)
    • max_enrolled_sites quota — PLG orgs capped at N sites (proposed: 1)
    • max_audit_runs_per_day quota — on-demand audit triggers capped per site per day (proposed: 3); scheduled worker runs unaffected
  • Documents 7 open questions requiring product decisions before any implementation
  • No production code changes — documentation only

🤖 Generated with Claude Code

Defines clear capability boundaries for all four tiers (PRE_ONBOARD,
PLG, FREE_TRIAL, PAID) — focusing on PLG vs FREE_TRIAL differentiation
including site count and audit run quotas.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 7, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@ravverma ravverma requested a review from solaris007 April 7, 2026 08:42
ravverma and others added 2 commits April 7, 2026 14:36
Callers should migrate to entitlement.getTier() === Entitlement.TIERS.PLG
directly once PLG tier is live in production.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 7, 2026

This PR will trigger no release when merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant