docs: weekly premium reset at renewal, faq item

[smakosh]

Summary

A MAX subscriber asked whether the Premium Models weekly allowance resets when the monthly billing cycle renews — they had traced the schema fields on GitHub and worried they'd need to front-load both included Reset Passes in the first days of each cycle to spend the full monthly allowance on premium models. The answer (renewal resets everything at once) only existed in code comments, so this documents it:

• apps/docs/content/learn/reset-passes.mdx: new Renewal and the weekly window section — monthly renewal zeroes premium usage and starts a fresh 7-day window alongside the credit reset, included passes replenish (purchased ones persist), immediate upgrades do the same full reset, and the window is rolling (re-anchors on next premium request; a redeemed pass clears it) so no timing debt can carry into the next cycle. Includes the five-windows-per-cycle arithmetic showing Max needs no front-loading.
• apps/code/src/components/Faq.tsx: matching FAQ item on the DevPass landing page (with FAQPage JSON-LD via the existing plain-text answer), linking to the learn page.

Behavior verified against apps/api/src/stripe.ts (renewal/upgrade resets), apps/worker/src/worker.ts (window re-anchoring on spend), and apps/api/src/routes/dev-plans.ts (pass redemption clearing the window).

https://claude.ai/code/session_01CHq6YUHyKc6Jv6ZaJddoZm

Summary by CodeRabbit

• Documentation
  • Added a new FAQ entry explaining how weekly premium allowances reset on plan renewal, including the rolling 7-day window behavior and Reset Pass effects.
  • Clarified renewal timing, tier upgrade impact, and how included vs. purchased Reset Passes persist until redeemed.
  • Expanded the Reset Passes documentation with a dedicated section and renewal/window examples.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 84bb630c-ccc4-4487-9426-191259a6ee1b

📥 Commits

Reviewing files that changed from the base of the PR and between 2b08ceb and fb33ddd.

📒 Files selected for processing (1)

• apps/code/src/components/Faq.tsx

🚧 Files skipped from review as they are similar to previous changes (1)

• apps/code/src/components/Faq.tsx

---

Walkthrough

Adds renewal and rolling-window explanations to the FAQ and Reset Passes documentation, including included-pass replenishment, purchased-pass persistence, and tier-upgrade behavior.

Changes

Weekly allowance documentation

Layer / File(s)	Summary
Renewal behavior content apps/code/src/components/Faq.tsx, apps/docs/content/learn/reset-passes.mdx	Adds FAQ and documentation content explaining monthly renewal resets, rolling 7-day windows, included-pass replenishment, tier upgrades, and purchased Reset Pass persistence.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• theopenco/llmgateway#3093: Adds the related Reset Passes behavior that this FAQ and documentation describe.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly reflects the main change: documenting weekly premium reset behavior and adding the FAQ item.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/reset-pass-billing-cycle

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/code/src/components/Faq.tsx`:
- Around line 144-145: Update the FAQ answer string in the relevant FAQ entry so
“nothing carries into the next cycle” explicitly refers only to the weekly
premium allowance and included Reset Passes, while preserving the separate
statement that purchased Reset Passes persist until redeemed.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 8857bcef-8b5d-4fe2-a1be-c9cd6ebe7a6e

📥 Commits

Reviewing files that changed from the base of the PR and between 4678e50 and 2b08ceb.

📒 Files selected for processing (2)

• apps/code/src/components/Faq.tsx
• apps/docs/content/learn/reset-passes.mdx