# GitHub Sponsors Setup — ThumbGate

## Current Status

| Check | Result |
|-------|--------|
| `hasSponsorsListing` (GraphQL) | **true** — listing exists |
| `is_sponsorable` (REST) | `null` — REST field not exposed; GraphQL confirms listing is live |
| Existing tiers (REST) | **404** — no tiers configured yet |
| Sponsors listing description | Present (generic open-source description, not ThumbGate-specific) |

**Summary:** The GitHub Sponsors profile for `IgorGanapolsky` is live and accepting sponsors, but no tiers have been created yet, and the listing description does not mention ThumbGate. Both need to be updated.

---

## Recommended Tier Structure

These tiers are donation rails, not the canonical ThumbGate pricing surface. Current commercial truth remains:

- Pro: `$19/mo or $149/yr` for individual operators.
- Team: `$49/seat/mo` with a `3`-seat minimum after workflow qualification.
- GitHub Sponsors should not publish alternate Team pricing or lifetime Pro claims.

### $5/mo — Supporter

**Perks:**
- Name listed in the ThumbGate README under "Sponsors"
- Early access to release notes and changelog before public announcement
- Access to the `#sponsors` discussion category on GitHub

**Rationale:** Entry point for individuals who use the free `thumbgate` npm package and want to give back. Low friction, no license delivery required.

---

### $19/mo — Pro Sponsor

**Perks:**
- Full **ThumbGate Pro** license equivalent to the public monthly Pro offer
- Access to Pro features: LanceDB vector similarity, Thompson Sampling bandit, ContextFS context packs, DPO export
- Priority support via GitHub Issues (SLA: response within 48 hours)
- All Supporter perks

**Rationale:** Mirrors the standalone ThumbGate Pro price point. Sponsors at this tier get the same commercial value as a direct Pro subscriber, with the added benefit of supporting open-source development.

---

### Team Sponsor — route to intake, not a fixed Sponsors tier

**Perks:**
- Shared hosted lesson DB
- Org dashboard and review surfaces
- Approval boundaries and rollout proof across operators
- Support scope defined after the Workflow Hardening Sprint

**Rationale:** GitHub Sponsors is too blunt for Team rollout. Team pricing starts at `$49/seat/mo` with a `3`-seat minimum and should be sold through intake so scope, seats, proof, and support boundaries are explicit.

---

## Step-by-Step: Create Tiers on GitHub Sponsors

The listing already exists. The only remaining step is adding tiers.

1. Go to [github.com/sponsors/IgorGanapolsky/manage](https://github.com/sponsors/IgorGanapolsky/manage)
2. Click **"Tiers"** in the left sidebar.
3. Click **"Add tier"** and fill in only the donation and Pro-equivalent tiers:
   - **Monthly price** (5, 19)
   - **Name** (Supporter, Pro Sponsor)
   - **Description** (copy from the perks above)
   - **Is one-time?** — leave unchecked (recurring monthly)
4. For the $19 tier, enable **"Welcome message"** with instructions on how to access the hosted/private `ThumbGate-Core` entitlement or managed Pro onboarding path.
5. Link Team buyers to the Workflow Hardening Sprint intake instead of adding a fixed Team Sponsor tier.
6. Click **"Publish"** on each tier.

To verify tiers are live after creation:

```bash
gh api users/IgorGanapolsky/sponsorship-tiers --jq '.[].monthly_price_in_dollars'
```

Expected output once tiers exist:
```
5
19
```

---

## Update the Sponsors Listing Description

The current listing description is generic. Replace it with ThumbGate-specific copy at:
[github.com/sponsors/IgorGanapolsky/manage](https://github.com/sponsors/IgorGanapolsky/manage) → **"Profile"**

Suggested description:

```markdown
## Support ThumbGate

**ThumbGate** is an open-source pre-action check system for AI coding agents.
It captures thumbs-up/down feedback, promotes it to persistent memory, generates
prevention rules, and blocks known-bad tool calls via PreToolUse hooks.

Sponsoring funds:
- Continued development of the free `thumbgate` npm package
- Private-core intelligence in `ThumbGate-Core`
- ContextFS context assembly and DPO export for fine-tuning pipelines
- Documentation, examples, and community support

Pro sponsors receive the commercial Pro entitlement backed by `ThumbGate-Core`. Team buyers should use the Workflow Hardening Sprint intake so shared rollout scope is qualified before seats are sold.
```

---

## Sponsor Perks Mapped to ThumbGate Pro Features

| Perk | ThumbGate Feature | Available At |
|------|-------------------|--------------|
| npm package access | `thumbgate` (free) | All tiers |
| Private core entitlement | `ThumbGate-Core` | $19+/mo |
| LanceDB vector similarity search | `npm run feedback:summary` with vector index | $19+/mo |
| Thompson Sampling bandit | Adaptive lesson retrieval | $19+/mo |
| ContextFS context packs | `npm run feedback:rules` context assembly | $19+/mo |
| DPO export for fine-tuning | `npm run feedback:export:dpo` | $19+/mo |
| Team rollout | Shared lesson DB, org visibility, approval boundaries | Intake, then $49/seat/mo |
| Minimum Team scope | Qualified workflow and at least 3 seats | Intake-led |

---

## Verification Commands

After tiers are created, run these to confirm the setup is complete:

```bash
# Confirm listing is live
gh api graphql -f query='{ user(login: "IgorGanapolsky") { hasSponsorsListing sponsorsListing { fullDescription } } }'

# Confirm tiers exist
gh api users/IgorGanapolsky/sponsorship-tiers --jq '.[].monthly_price_in_dollars'

# Check repo has Sponsor button configured (.github/FUNDING.yml)
cat .github/FUNDING.yml
```

### .github/FUNDING.yml (create if missing)

```yaml
github: IgorGanapolsky
```

This adds the **"Sponsor"** button to the top of the `IgorGanapolsky/ThumbGate` repository page.
