Session Handoff — P2P Engine: Stars access, free-tier paywall, instant-signup auth, tool-picker redesign

Where it started

Sondra was prepping a live demo of The Pain-2-Profit Engine (live at pain2profitengine.com) for her Stars members and didn't know what the Stars perk was or how members get access. Session grew into: fixing the free tier so it can't be farmed, fixing a confusing signup loop, redesigning the build-tool picker, and capturing a backlog of tool-clarity decisions. App code lives in c:\Users\srver\AIOS-Workspace\aios-starter-kit\PROJECTS\Pain-2-Profit Engine\app\ (own git repo, main, NO remote). Supabase project kgxwuhkvoyvrnifvlnqz. Deploy = Cloudflare Pages project pain2profit-engine via npx wrangler pages deploy dist --project-name=pain2profit-engine --branch=main --commit-dirty=true (needs CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID from master .env).

Decisions locked + what shipped (all LIVE on pain2profitengine.com)

• Credits are NOT dollars. "10" = credits (the app's internal currency users buy or Stars get free). Research Hunt = 5 credits, Profit Plan = 10 credits. Sondra's REAL cost per run = the underlying AI calls (1 Perplexity/OpenRouter research + 3 Claude sonnet-5 calls in generate-gameplan) = cents-to-~$1, NOT $10. Origin of the scare: in a design note Claude wrote "re-running the whole $10 plan" — a WORDING ERROR; it should read "10-credit plan." Never call credit amounts dollars. She was alarmed thinking each use cost her $10 — corrected. She wants the actual per-run $ pulled (see Open).
• Free tier = ONE scored report. New-account grant cut 100 → 5 credits (migration free_tier_one_report, applied; handle_new_user() now inserts balance 5). 5 credits = one Research Hunt → scored ideas + citations, but NOT enough for the 10-credit plan. The downloadable Strategic Plan + build prompt is the paywall (credits or Stars). File: app\supabase\migrations\0009_free_tier_one_report.sql.
• Upgrade wall on app\src\pages\ResearchResults.jsx: when balance < 10, the "Generate Profit Plan" button becomes "🔒 Unlock the Strategic Plan + Build Prompt" → routes to /pricing + names Stars.
• Funnel copy de-over-promised in app\src\pages\Landing.jsx: every "free full run / research AND the full plan free" claim now says "free scored idea report; plan unlocks with credits or Stars." FAQ "What do I get for free" rewritten.
• Landing Stars section added (navy, id="stars", above FAQ): "Don't Buy Credits. Get a Complete App Plan Free — Every Month." Two-col compare (Pay with credits vs Become a Star ⭐). CTAs: "Upgrade to Stars →" https://www.skool.com/amplif-ai-your-business/plans; "Not in the community yet? Join free first →" https://www.skool.com/amplif-ai-your-business. No price shown (per her call — price mid-flip $33→$47).
• Signup-screen STARS banner (app\src\pages\Login.jsx, signup mode): bold gold-bordered "⭐ Amplif-AI Premium STARS Members: use your Skool email to unlock your free monthly plan."
• Instant signup — email confirmation TURNED OFF via Supabase Management API (mailer_autoconfirm=true). Fixes the confusing "no check-your-email / sign-in loop" AND removes the ugly "Supabase Auth" email for the demo. Verified: fresh signup returns an access_token immediately and lands on /dashboard with 5 credits. TEMPORARY demo hack — re-enable later WITH a branded Resend email (see Deferred).
• Auth modal redesigned signup-first (Login.jsx): defaults to signup (was signin), one big navy/gold "Create My Free Account →" + small "Already have an account? Sign in" link. Honors ?mode=signin; Landing header "Sign In" now → /login?mode=signin. Also added a "📧 Check your email" screen + friendlier "not confirmed" error (safety net for when confirmation is re-enabled).
• Build-tool picker redesigned (Pass 1, her exact spec) in app\src\pages\NewIdea.jsx: label "Which tool are you building with?", NO default (placeholder "Choose your tool…", run button disabled until chosen — this was the exact demo bug: it defaulted to Claude Code so you could skip it). Options in order: Bolt, Lovable, Base44, Replit, Emergent, v0, Other AI app builder, AI coding agent (Claude Code, Codex, Cursor, Anti-gravity, etc.). Removed the old free-text "other" input.
• Backend prompt templates (app\supabase\functions\generate-gameplan\index.ts, deployed): named builders keep tool-specific TOOL_NOTES; added other-builder (generic app-builder template) + coding-agent (generic coding-agent spec). Gameplan.jsx shows a friendly tool label on the Build Prompt tab.
• Deleted two test users from auth.users: sondraverva@gmail.com, digitalbeachgirl@gmail.com (cascade cleaned all app rows). KEPT srverva@gmail.com (admin, balance 135) — untouched.
• Naming decision: leave "Profit Plan" as-is (no rename).
• Stars sync ran (scripts\p2p_stars_sync.py): 42 star emails recognized, 0 flagged (none have app accounts yet). Nightly task "AIOS P2P Stars Sync" 7:15am flags Stars once they sign up for the APP with their Skool email.

Decisions locked but NOT yet built (next session's work)

• Tool-switch feature = 3 credits (APPROVED). On the finished plan's Build Prompt tab add "Building with a different tool?" → tool dropdown → "Regenerate for this tool (3 credits)" (show the credit cost on the button). Regenerate ONLY the build prompt (not the whole plan). REPLACE the old prompt (don't keep both).
• DESIGN CONSTRAINT (address this): the gameplans row stores idea + guardrails + build_tool + citations but NOT the raw research text — research is fetched transiently during generation. The build prompt is ~95% driven by idea + guardrails (research only seasons microcopy, research.slice(0,6000)), so a retool needs NO re-research → one Claude call, cheap. To keep audit-mode correct on retool, persist build_context (is_audit, app_url, app_status, existing) on the gameplan at generation; optionally persist research_text too if you want the microcopy seasoning.
• Build via a NEW mini edge fn (e.g. retool-prompt) that duplicates toolNote() + the 16-section build-prompt template rather than refactoring the live money-path generate-gameplan. Charge 3 credits, update { build_prompt, build_tool }.
• "Other AI app builder" → ask the tool name. Bring back a free-text input when "Other" is chosen; backend toolNote() already tailors to any typed tool name. Better than a blanket generic template (her instinct, correct). Coding-agent bucket stays ONE spec (Claude Code/Codex/Cursor/Antigravity are interchangeable at the prompt level — user picks the model inside) but make its output visibly premium (recommended stack + build order).
• Wait-time expectation message — after "Generate Profit Plan," tell them "~3–5 min, leave and come back from your Dashboard, we'll have it waiting." Generation runs 3 parallel Claude 30k-token calls, genuinely minutes not seconds.
• Explicit "what costs what" area — a clear place (credits page / FAQ / new "How it works" area) laying out every action's credit cost up front: Research Hunt 5, Profit Plan 10, tool-switch 3, chat (free? — decide), Discover niche scan (she saw "cost 3 credits"). People know how to BUY credits but nothing explains WHAT they are or what each does. She wants to look at Travis's ideas.paidcreators.com for reference.
• New-user onboarding for the 5 free credits — first-run is confusing. Idea: a welcome (confetti) that drops them on the New Idea page ("spend your 5 credits: audit an existing app or start a new idea"), OR guide them to Discover to explore first. Clarify the Discover → research → credit flow.
• Chat cost — UI must state whether chat is free and how many sessions. Currently silent.
• Training area — must say "Coming Soon" (not built yet).

Key files for next session

• c:\Users\srver\AIOS-Workspace\aios-starter-kit\PROJECTS\Pain-2-Profit Engine\app\src\pages\NewIdea.jsx — intake + build-tool picker (BUILD_TOOLS list, no-default gate)
• ...\app\src\pages\Gameplan.jsx — finished plan (Overview/Strategic Plan/Build Prompt tabs); where the tool-switch button + back-to-top go
• ...\app\src\pages\ResearchResults.jsx — scored ideas + the upgrade wall
• ...\app\src\pages\Landing.jsx — funnel; Stars section (id="stars"), pricing FAQ
• ...\app\src\pages\Login.jsx — signup-first auth modal + STARS banner
• ...\app\supabase\functions\generate-gameplan\index.ts — TOOL_NOTES/toolNote, the 16-section build-prompt template, credit spend (GAMEPLAN_COST=10). gameplans row does NOT store raw research (only citations) — relevant to building retool.
• ...\app\supabase\functions\research\index.ts — RESEARCH_COST=5
• c:\Users\srver\AIOS-Workspace\aios-starter-kit\scripts\p2p_stars_sync.py — nightly Stars flag sync (matches Skool email OR Answer3)
• Plan file: none (no plan drove this session)
• Memory files touched: none

Running state

• Background processes: a stray vite preview on port 4933 started this session (detached). Kill: powershell "Get-NetTCPConnection -LocalPort 4933 | %{ Stop-Process -Id $_.OwningProcess -Force }". Also old detached vite on 4901 from prior sessions.
• Dev servers / ports: 4933 (preview, this session), 4901 (old dev). Neither needed.
• Open worktrees / branches: app repo on main, no remote. Workspace repo has many uncommitted changes.

Verification — how to confirm things still work

• curl -s -o /dev/null -w "%{http_code}" https://pain2profitengine.com/pricing → 200
• New signup grant: Supabase → select balance from public.user_credits order by created_at desc limit 1; after a fresh signup → 5
• Auth is instant: signup at pain2profitengine.com → lands on /dashboard, no email
• Build-tool picker: sign in → /new → dropdown opens on "Choose your tool…", run button disabled until a tool is picked
• Stars sync: python -X utf8 scripts/p2p_stars_sync.py → "42 unique star emails", no errors

Deferred + open questions

• Open (ACTION she asked for): pull the REAL per-run cost — Sondra's actual Anthropic + OpenRouter usage in dollars, so she trusts the economics. Not yet done.
• Open (ACTION): flag her current Stars member. A Stars member signed up TODAY. To get instant access she must have an app account at pain2profitengine.com with her Skool email; then run scripts\p2p_stars_sync.py (or Admin ⭐ toggle) and she gets 15 credits = one full run/month. Sondra needs to send the member's email to flag her now instead of waiting for the 7:15am sync.
• Deferred: re-enable email confirmation WITH a branded Resend email from her domain (currently OFF for the demo). Then the "Check your email" screen already built kicks in.
• Deferred: GitHub backup remote for the app repo still not set (both PATs are fine-grained without repo-create). Fix = mint a token with repo-create or manually create private pain2profit-engine repo, then git remote add origin … && git push -u origin main.
• Deferred: back-to-top button on the long Strategic Plan / Build Prompt views (she raised it, undecided).
• Deferred: prompt sequencing — a "how to feed this in" note per tool (agentic tools = paste whole brief; app builders = section-by-section via the Build Order). Future enhancement.
• Deferred: /app-safety-check before any real (non-demo) launch — email confirmation is currently off and prices are live-as-built ($19/50, $49/150, $99/400, founder $99/500, never formally confirmed).
• Stars pricing mid-flip ($33→$47/mo) — landing intentionally shows no price.

Pick up here

Build the approved tool-switch feature (3 credits, replace-not-keep, on Gameplan's Build Prompt tab) + the "Other → name your tool" tailoring + the wait-time message; and pull Sondra's real per-run AI cost so she can see it's cents, not $10.