Home · Store · Library

How a bot buys / opens stacks

Machine-oriented notes for agents assisting operators. Humans stay in charge of checkout.

1. Discover

• Public store: https://stackyard.fyi/store.html
• Public Founders hooks: https://stackyard.fyi/#founders-bonus
• Free Issue 1: https://stackyard.fyi/issue-001.html
• Session JSON: GET https://stackyard.fyi/api/gate/me (credentials / cookie)

2. Free account (email opt-in)

POST /api/gate/signup
Content-Type: application/json

{ "email": "[email protected]", "opt_in": true }

Requires opt_in: true. Sends welcome via Resend. Does not grant paid library packs.

3. Sign in

1. POST /auth/magic-link with { "email" }
2. Human opens magic link → sets sy_member HttpOnly cookie
3. GET /api/gate/me → tier, entitlements, username

4. Buy (one-time Payment Links)

• Founders Bonus $5: https://buy.stripe.com/fZu5kx02R8iCdA57Sg00002 → entitlement founders-bonus
• Fail-Closed Toolkit $7: https://buy.stripe.com/8x214hdTHdCW1Rn2xW00003 → fail-closed-toolkit
• Untrusted Tool Results $7: https://buy.stripe.com/14A28l9DrdCWeE94G400004 → untrusted-tool-results
• Success redirect: /auth/claim?session_id={CHECKOUT_SESSION_ID}

4b. Buy (human completes Stripe)

• Operator $10/mo: https://buy.stripe.com/aFa3cpdTH6au53z8Wk00000
• Operator+Agents $20/mo: https://buy.stripe.com/fZuaERaHvbuOfIda0o00001
• Success → /auth/claim?session_id=… → cookie + redirect /members/
• $5 Founders à la carte: held until Human approves Stripe one-time

Agents must not invent card numbers or complete checkout without the human.

5. Open stacks

• Library index: /members/
• Store — Fail-Closed Toolkit: /members/store/fail-closed-toolkit.html (entitlement fail-closed-toolkit)
• Store — Untrusted Tool Results: /members/store/untrusted-tool-results.html (entitlement untrusted-tool-results)
• Founders Smoke Alarm: /members/founders-bonus.html (+ .md / .json for $20 tier)
• JSON packs require tier=operator_agents (or admin)
• Free tier: Issue 1 public only; Founders/airdrops → 402

6. Entitlements

/api/gate/me may include entitlements[] (e.g. airdrop ids). Catch-up sales appear on /store.html#catchup-store after hold — Stripe products TBD.

Calendar: crew ops file ops/airdrop-calendar-2026-09.md. Site mirror list on store catch-up card.