Plan: angle videos + matched ?v= squeeze pages for promo tools

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

docs/PROMO-ANGLE-VIDEOS-PLAN.md

@@ -0,0 +1,69 @@
+# InstantAdPay angle videos + squeeze pages (plan, 2026-09-09)
+
+Same machine RM Circle runs: a short hook video per angle, a matched squeeze
+page at `instantadpay.com/join/<you>?v=<angle>`, a card in Promo tools with the
+matched link, and paste-ready copy. Draft for Marty's review. Nothing here is
+built yet except what "Already in place" lists.
+
+## Already in place
+
+- Join links: `/join/<username | share code | member #>` set the sponsor cookie and 302 to the home page. No `?v=` handling yet.
+- Promo tools pane: personalized posts, one email swipe, banner wall link, banner images. No videos, no matched links.
+- Home page has the signature visuals to reuse: the animated ledger mockup (member #7 buys, level 1/2/3 payouts land), the 3-generation isometric viz, the package ladder.
+- Free distribution for the finished videos: the video ad format on the site itself (house ads, no cost) and NAS syndication for banner/text.
+- Video pipeline from RM Circle: HyperFrames (Node 22) + ElevenLabs "Marty Normal Voice", build.py timing from VO files, lint, render, loudnorm, compress, hash-named under `public/v/`.
+
+## Contract facts every script must stay inside
+
+- Packages: $5 / $20 / $50 / $100 / $250 mint 500 / 2,000 / 5,500 / 12,000 / 32,500 credits. One credit = one cent of ad delivery.
+- Split on every purchase, in the same Polygon transaction: 50% direct sponsor, 20% level 2, 10% level 3, 20% platform. Paid to wallets, nothing to claim.
+- Qualification to receive: level 1 pays any activated sponsor; level 2 needs 2 qualifying buyers ($20+); level 3 needs 5.
+- Seven ad formats: banner, text, login, solo, video, featured link, verified visits. Members earn credits by viewing.
+- Join is free by email. Wallet comes out at purchase or when switching payouts on.
+- Dollar package prices are fixed constants and may be spoken. POL amounts and POL/USD are never baked into audio or frames (evergreen rule).
+- Every video ends on the disclaimer card: "No income guaranteed. Results depend on your effort. Crypto involves risk of loss."
+
+## The five angles
+
+| key | working title | hook (first line) | for whom | shape | proof beat |
+|---|---|---|---|---|---|
+| `instant` | Paid before the page reloads | "What if your commission landed before the thank-you page finished loading?" | everyone; flagship | PAS, ~60s | ledger rows animate: purchase, three payouts, same block |
+| `adspend` | You were buying traffic anyway | "Every ad dollar you have ever spent went one direction. Out." | marketers who buy ads | AIDA, ~55s | package ladder + "your buyers' ad spend pays your line" |
+| `free` | Watch first, spend never | "You can run your first ad campaign here for exactly zero dollars." | tire kickers, earn-side | PAS, ~50s | earn credits by viewing, welcome credits, first campaign |
+| `ledger` | No back office. No payday. | "Your last affiliate program paid you on the 15th. If it paid you." | skeptics, burned affiliates | PAS, ~55s | Polygonscan / live ledger as the payroll |
+| `two` | Two buyers open level two | "Two buyers. Then five. That is the whole ladder." | builders | AIDA, ~55s | 3-generation viz lights up 50 / 20 / 10 |
+
+Recommended first three: `instant`, `adspend`, `free`. `ledger` and `two` follow once the page mechanism is live. Landscape 16:9 for the squeeze page; a 9:16 cut of each for social if Marty wants it.
+
+## Squeeze page mechanics
+
+- `/join/<token>?v=<angle>` serves `join.html`: hook headline, video with poster, three proof chips (same transaction, public ledger, join free), "You're joining under @username", inline email join. Plain `/join/<token>` keeps redirecting to the home page.
+- Sponsor cookie set exactly as today. The `v` also rides into the account (`sponsor_ref` stays as is; add `joined_via`) so we can see which hook converts.
+- Per-angle og/twitter tags with `og:url` INCLUDING `?v=` (Facebook canonicalizes shares to og:url; RM Circle lost its variants once this way).
+- Promo tools: one card per video with preview, "Copy matched link", download buttons for both cuts, a post per network, an SMS-length message, and share buttons (Text, WhatsApp, Telegram, Copy).
+- Each finished video also goes live as a house video ad and its squeeze page as a house login ad.
+
+## Production pipeline (mirrors RM Circle)
+
+1. Scripts: written from this brief through the bv-tester1 engine with the contract facts pasted in, then checked line by line against the facts above. No em dashes, no income claims, no POL figures.
+2. Project per video at `D:\Projects\HighRisk\onchain-ad-membership\video-<angle>` (assets/scenes.json, tts.cjs, build.py, index.html), same as `video-phone`.
+3. Silent draft first, rendered with the site palette (mint #43e8c3 on #0b1512, Sora display, mono ledger rows). Marty approves visuals and copy.
+4. Voice: ElevenLabs clone by default, or Marty records to a teleprompter script (6 files, vo1 to vo6). Timing re-derives from the audio either way.
+5. Render 1080p30, loudnorm to -14 LUFS, compress (crf 26, faststart), hash-name into `public/v/`, poster frame, og image per angle.
+6. Ship the squeeze page, promo cards, house ads, and the chatbot answer update together.
+
+## Order of work
+
+1. Marty picks the first three angles and the voice route.
+2. Five scripts drafted and verified; Marty approves.
+3. Squeeze page + og tags + promo cards shipped with poster placeholders, so links work before videos exist.
+4. Silent drafts, approval, voiced finals, deploy.
+5. House ads placed, launch posts in Marty's voice on massifly and Telegram.
+
+## Decisions for Marty
+
+- Which three angles first? (Recommendation above.)
+- Voice clone or your own recording?
+- Squeeze page CTA: inline email join (recommended) or send to the home page?
+- Do you want 9:16 cuts for socials from day one?
+- Scripts through the Branded Voice engine, or written directly in your style?