diff --git a/docs/archive/2026-09-13-karaokehunt-outreach-handoff.md b/docs/archive/2026-09-13-karaokehunt-outreach-handoff.md index 645a9e08..d3e8303e 100644 --- a/docs/archive/2026-09-13-karaokehunt-outreach-handoff.md +++ b/docs/archive/2026-09-13-karaokehunt-outreach-handoff.md @@ -1,5 +1,20 @@ # KaraokeHunt decommission + user outreach — session handoff (2026-09-13) +> **SESSION 5 — PHASE C STARTED (2026-09-17)** +> - Review triage (`outreach_out/review_triage.json`): 15 EASY (Andrew DONE) · 26 MEDIUM +> (10 opened in tabs for him) · 34 SKIP (non-English/no-reference → users review). +> - **One-click authed review links SHIPPED + verified in prod** (PR #1015 + #1016): +> `POST /api/admin/users/{email}/login-link {expiry_hours≤168, purpose:"job_review:"}` +> → URL logs the user in (scanner-safe interstitial) and lands directly on that job's +> review page. Mint at email-drafting time (7-day expiry). +> - **Reassignment DONE**: 62 jobs (28 complete + 34 skip) reassigned to their requesters; +> 49 accounts (48 created silently with 3 credits; @ pre-existed, NO +> credits granted — /admin/credits would email them). `outreach_out/phasec_state.json`. +> - **Email batch 1 DRAFTED in Andrew's Gmail (10 drafts, NOT sent)** — completed-video +> variant for fully-resolved English requesters. 9 more fully-resolved await batching +> (incl. he/it/es speakers — bilingual after wording approved). Skip-pile emails next: +> mint per-user job_review links at draft time. + > **SESSION 4 — BATCH GENERATION EXECUTED (2026-09-15, autonomous overnight)** > All 90 unique songs SUBMITTED as public jobs owned by holding account > **karaokehunt@nomadkaraoke.com** (created, 120 credits; @nomadkaraoke.com catchall → diff --git a/docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md b/docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md new file mode 100644 index 00000000..25297e2e --- /dev/null +++ b/docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md @@ -0,0 +1,190 @@ +# KaraokeHunt outreach — Phase C handoff (2026-09-19) + +**Purpose:** hand a FRESH session everything needed to finish the KaraokeHunt outreach +and fully draw a line under the KaraokeHunt era. This doc is self-contained for the +remaining work; deep history lives in +[`2026-09-13-karaokehunt-outreach-handoff.md`](2026-09-13-karaokehunt-outreach-handoff.md) +(sessions 1–5 prepended chronologically) and memory `project_karaokehunt_batch_generation`. + +Worktree: `/Users/andrew/Projects/nomadkaraoke/karaoke-gen-karaokehunt-outreach` +Branch: `feat/sess-20260913-0106-karaokehunt-outreach` (long-running; several PRs already +squash-merged from it — #1004 #1005 #1015 #1016; unmerged tip = docs only). + +--- + +## 1. Mission state (UPDATED 2026-09-23 — reviews DONE, all 90 reassigned) + +90 unique requested songs were generated as public jobs under holding account +**karaokehunt@nomadkaraoke.com** (all job emails → @nomadkaraoke.com catchall → Andrew's +gmail). **Final fleet state (2026-09-23):** + +- **complete: 55** (live on YouTube, NOMAD-#### numbered) +- **in_review: 25** · **awaiting_review: 10** — these 35 are the skip pile (+ resubmitted + Bhimsen 7a16be60): the REQUESTERS review them via one-click links. +- Ownership: **ALL 90 jobs reassigned to requesters; karaokehunt@ holding account is + CLEAR.** 63 requester accounts exist (see `phasec_state.json`; = + `exists_via_interceptor_no_silent_credits` — mention credits in their email; same for + ). + +**ANDREW IS DONE REVIEWING (his directive, 2026-09-23):** all 15 EASY + all 26 MEDIUM +reviewed and complete. He will review NO more of these jobs. Anything still pending is +handled by the requesting users via one-click links, and **cleaned up if the requester +takes no action within 2 WEEKS of us sending their outreach email** (track send dates +per batch; cleanup = cancel/delete the parked job, account+credits stay). + +Final segmentation (recompute with the snippet that produced it — session 2026-09-23): +- **Batch 1** (drafted 09-17, in Gmail drafts, UNSENT): 10 fully-resolved en requesters. +- **Batch 2 candidates**: 24 more requesters whose songs are ALL complete (incl. + bilingual: he, it, es, es, sv). +- **Skip-pile/mixed**: 29 requesters with ≥1 pending user-review job (some also have + completed songs — ONE email each covering both, links minted at draft time). +- **No-generated-jobs**: 24 requesters (community-only / no-match variants). + +Related: the **app-request interceptor is LIVE** (v0.236.0, session record +`docs/sessions/2026-Q3/2026-09-22-karaokehunt-app-interceptor.md`) — any NEW requests +from old app installs auto-convert (one freebie ever, community short-circuit, +uninstall emails). This outreach covers only the historical 90. + +## 2. Where everything lives + +Local PII dir (NEVER commit): `old-or-other/karaokehunt-users-export-2026-09-09/outreach_out/` +- `batch_state.json` — song → job_id → requester email(s). THE core mapping. +- `phasec_state.json` — accounts created (49; 3 credits each) + 62 job reassignments. +- `review_triage.json` — easy/medium/skip with job_ids + per-song signals. +- `actions_v3.json` — per-requester buckets (community/torrent/cmake/no_match/dropped). +- `language_inference.json` — per-requester locale+confidence (28 non-en of 89). +- earlier artifacts: canonical_v2.json, audio_search_cache.json, review packets. + +Scripts (committed): `scripts/karaokehunt_outreach/` (phase1b/1c, phase2_execute, +phase_batch_generate, torrent_review). + +Google Sheet (Andrew's Drive): "KaraokeHunt Outreach — Torrent Review v2 (2026-09-13)". + +## 3. Verified mechanics & HARD-WON GOTCHAS + +- **Admin browser login (for opening review tabs)**: in the playwright browser, on + gen.nomadkaraoke.com run `localStorage.setItem('karaoke_access_token', '')` + (token: `gcloud secrets versions access latest --secret=admin-tokens --project=nomadkaraoke | cut -d',' -f1`). + Review URL: `https://gen.nomadkaraoke.com/app/jobs#//review`. + **Andrew reviews in playwright-chrome-3** (profile already logged in as admin). +- **One-click authed review links (SHIPPED + prod-verified)**: + `POST /api/admin/users/{email}/login-link {"expiry_hours": 168, "purpose": "job_review:"}` + (admin token) → `{url}`. The URL shows a scanner-safe "Complete Sign-In" click, logs the + user in, lands DIRECTLY on that job's review page. **Mint at email-draft time** (7-day + expiry). PRs #1015 (backend) + #1016 (frontend hash-redirect fix). +- **Reassignment**: `PATCH /api/admin/jobs/{id} {"user_email": ...}` — silent, + auto-creates account if missing (but create properly with credits FIRST). +- **Account creation**: `POST /api/users/admin/users {email, initial_credits: 3, + credit_reason: "KaraokeHunt outreach — apology credits"}` — SILENT. 409 = exists; + **`/api/users/admin/credits` EMAILS the user — never use it silently** + ( pre-existed → got NO credits yet; mention in their email). +- **made_for_you is DUAL-ROLE**: exempts from stale-review 48h auto-expiry AND blocks + auto-approval enforcement. All still-parked jobs have MFY=true (no expiry). To full-auto + eval: flip MFY false → `POST /api/internal/jobs/{id}/auto-approval-eval` → re-flag. +- **Failed jobs**: `POST /api/jobs/{id}/retry` (admin) resumes from last checkpoint — + worked for RED download failures and an encoding-worker disconnect. Tangled jobs: + cancel + resubmit fresh. +- **NEVER scrape karaokenerds.com** — workspace `docs/KARAOKENERDS-DATA-ACCESS.md`. +- **RED IP-bans torrent-fetch bursts** (~60/hr got flacup banned ~90 min). Irrelevant now + (downloads done) unless resubmitting. +- **EMAIL POLICY (standing)**: Andrew reviews ALL outreach emails; DRAFTS in his Gmail + (via Gmail MCP `create_draft`); he sends in batches of ~10, waits a day, reviews + reactions. NEVER send programmatically. + +## 4. NEXT STEPS, in order + +1. ~~Open the 16 remaining medium tabs~~ ✅ DONE 2026-09-20; Andrew reviewed all by 09-23. +2. ~~Reassign newly-completed jobs~~ ✅ DONE 2026-09-23 — all 90 reassigned, holding + account clear, phasec_state.json current. +3. **Email batches** (Gmail drafts; to-addresses = requester; Andrew sends ~10/day): + - **Batch 1 ✅ SENT by Andrew 2026-09-24 ~04:13 UTC** (all 10 confirmed in Sent, + From andrew@nomadkaraoke.com): , , , + , , , , , + , . Batch-1 wording is APPROVED FINAL = the template. + ➜ NEXT: monitor replies/bounces in Andrew's Gmail over the coming days. + - **DECISION (Andrew, 2026-09-24): NO bilingual bodies** — every batch uses the + English template; the multilingual PS strip + hosted /karaokehunt page covers + non-English speakers. (Supersedes the earlier bilingual-body plan for batch 2.) + - **DRAFTING CONVENTIONS (Andrew, 2026-09-23 — apply to ALL later batches):** + (a) NO em-dashes — hyphens only, subject + body; (b) include the original + request date: "a while back (April 1st 2025) you requested…" (dates per song in + `actions_v3.json`; requests <~2 months old get softened wording — no "far too + long"); (c) From = andrew@nomadkaraoke.com with his real Gmail signature. + ⚠️ The Gmail API/MCP CANNOT set From and mangles the signature+links + (google.com/url wrappers) — draft via the Gmail UI in playwright-chrome-3: + Compose → From dropdown → nomadkaraoke (signature auto-inserts) → To/Subject + via fill → body via `document.execCommand('insertText')` at collapsed-to-start + selection (fill() wipes the signature; insertHTML is Trusted-Types-blocked). + Sign-off "Cheers,\nAndrew" (signature block follows). + - **ALL REMAINING SEGMENT-A EMAILS ✅ DRAFTED 2026-09-24 (77 Gmail drafts, + verified count)**: batch 2 (24 complete), skip-pile (29, one-click links minted + 168h on 09-24 — LINKS EXPIRE ~Oct 1; if sending slips past ~Sep 28, re-mint and + update drafts), community-only (19) + no-match (5). Content archive: + `outreach_out/drafted_emails_2026-09-24.json`; links: + `outreach_out/minted_links_2026-09-24.txt`. + ✅ **ALL 77 SENT 2026-09-24 ~05:00-05:53 UTC** (Andrew approved exemplars per + type; sent via Gmail UI in 8 batches of ~10 with ~6.5 min gaps; 0 failures; + 0 KaraokeHunt drafts remain). **SEGMENT A IS COMPLETE: all 87 requester + outreach emails sent.** 2-week inaction cleanup clock for the 35 parked + review jobs runs to **~2026-10-08**; review links expire ~Oct 1 (re-mint + on request if someone replies late). + ⚠️ DRAFTING GOTCHA: rapid scripted composes get their saves silently DROPPED by + Gmail — always wait for the compose header's "Draft saved" ack before Save & + close, and verify the drafts count grew after each batch. + - **Skip-pile batches (29 requesters, 35 pending jobs)**: "we made a first draft — + review the lyrics yourself with one click" variant. MINT the per-job one-click link + at draft time (`job_review:`, 168h). Users get their 3 credits + mentioned. Requesters with BOTH complete + pending songs (, + , , , ) get ONE combined email. + - **⏲ 2-WEEK CLEANUP RULE (Andrew, 2026-09-23)**: any job still unactioned by its + requester 2 weeks after their email was SENT → clean up (cancel/delete the parked + job; accounts + credits stay). Track send date per batch. + - **No-match-only + community-only requesters** (from actions_v3: no_match rows and + requesters whose only songs were community links) — "couldn't find a clear match / + here's the existing version" variants + credits. + - After each batch: check replies/bounces in Andrew's Gmail before the next. + - **ENGAGEMENT TRACKING — Andrew's Gmail send-as relays via POSTMARK SMTP, so + opens AND link clicks ARE tracked** (server token = Secret Manager + `postmark-server-token`; feeds: `/messages/outbound/opens` + `/clicks`, + filter Recipient against the 87). Also server-side: (a) logins: + `gen_users/{email}.last_login_at`; (b) parked-job status flips in `jobs`; + (c) `total_jobs_created`; (d) /karaokehunt views: CF zone analytics; + (e) replies/bounces in Gmail. First hours (by ~11:15 UTC 09-24): 28/87 + opened, 6 link clicks, first full conversion (clicked 06:43 UTC, + BABYMONSTER FOREVER reviewed → YouTube by 06:59, ~1h after send). +4. ~~Hosted localized letter page~~ ✅ SHIPPED 2026-09-23 (PR #1044, v0.238.1): + **https://gen.nomadkaraoke.com/karaokehunt** — bare URL locale-redirects, page has + language switcher, all 33 locales. **Andrew: include the link in ALL emails** (even + guessed-English recipients) as a PS line before the signature: + a two-line PS before the signature (batch 1 already has it): + "PS: You can read this note in your own language at + https://gen.nomadkaraoke.com/karaokehunt" + a native-language strip + "Español · Português · Français · Italiano · Svenska · Filipino · Bahasa + Indonesia · Tiếng Việt · 한국어 · 中文 · हिन्दी · العربية · עברית · +19 more" + (the inferred requester languages, so recipients recognise theirs). +5. **Segments B & C** (after Segment A settles): B = 266 app-users-never-requested, + C = 37 kit-only. Drafts exist from phase 1 (`outreach_out/review_packet_bc.md` — needs + refresh with final wording + credits). ⚠️ **C overlaps Frog #1 launch-email** — + reconcile to ONE offer with Andrew before sending C. +6. **Draw the line under KaraokeHunt** (final cleanup): + - All 90 jobs at final state + reassigned; karaokehunt@ holding account left as + archive (or zero its credits). + - GCP **Phase E is ungated**: `gcloud projects delete projectbread-karaokay` + close + billing acct `0123B3-AAC0D8-4344D3` (needs Andrew's auth'd gcloud; ask him). + - Play/App Store: apps already unpublished (do NOT "Delete app" on Play — keeps + analytics). + - BACKLOG: `/backlog-finish` Frog #2 "KaraokeHunt order-email recovery + app + redirect" when emails are flowing; move to CHANGELOG. + - Memory: update `project_karaokehunt_batch_generation` + MEMORY.md when done. + +## 5. Loose ends / known issues + +- 3 pre-existing gen users among requesters (see `outreach_out/existing_gen_users.txt`, + local): no silent credit path — handle in their emails (offer to add credits on reply, + or Andrew grants via admin UI accepting the notification email). +- Post-deploy canary (happy-path E2E) was flaky/failing on some main runs during batch + load; PyPI publish failed on the 0.225.7 run — another session was on CI/errors. +- 2 cancelled jobs are expected (Emily King CF-524 duplicate; tangled Bhimsen original). +- Multi-song requesters not yet fully resolved (e.g. ~15 songs, , + , , hello@thepropervolume) — email each ONCE when their + whole set resolves; their skip-pile songs get one-click links in the same email. diff --git a/docs/archive/2026-09-24-karaokehunt-final-phase-handoff.md b/docs/archive/2026-09-24-karaokehunt-final-phase-handoff.md new file mode 100644 index 00000000..a83286b0 --- /dev/null +++ b/docs/archive/2026-09-24-karaokehunt-final-phase-handoff.md @@ -0,0 +1,147 @@ +# KaraokeHunt outreach — FINAL PHASE handoff (2026-09-24) + +**Purpose:** Segment A is COMPLETE. This doc hands a fresh session everything needed +for the remaining KaraokeHunt-era work: reply/engagement monitoring, the Oct-8 cleanup +sweep, Segments B & C, and the final line-drawing (GCP Phase E, /backlog-finish). +Deep history: [`2026-09-19-karaokehunt-outreach-phase-c-handoff.md`](2026-09-19-karaokehunt-outreach-phase-c-handoff.md) +(now fully ✅ through step 3) and memory `project_karaokehunt_batch_generation`. + +Worktree: `/Users/andrew/Projects/nomadkaraoke/karaoke-gen-karaokehunt-outreach` +Branch: `feat/sess-20260913-0106-karaokehunt-outreach` (docs-only tip; PRs #1004 #1005 +#1015 #1016 + letter-page #1044 all merged/deployed). + +## 0. UPDATE 2026-09-24 (later session) — Segments B + C SENT + +- **Segment B SENT 238/238** (11:05 local, 0 errors): KaraokeHunt APP registrants who never + requested (NOT Kit form signups). 266 → 238 after dropping 17 test/disposable/typo, 10 who + DELETED their KH account (`karaokehunt_account_deletions.csv` — check this for any future + send!), 1 existing Gen user (@). All 238 got accounts + 3 credits SILENTLY first + (`POST /api/users/admin/users`, 0 conflicts). Andrew approved a test at andrew@beveridge.uk. +- **Segment C SENT 35/35** = Frog #1 launch email (Andrew: fold C into Frog #1). Kit list is + mostly app users bulk-imported 2026-04-23 (301/348 rows) — so Frog #1's audience is ONLY these + 35 genuine form signups; the rest already got A/B. CTA = vanity referral link + `nomadkaraoke.com/r/thankyou50` (50% off 90d, attaches on next sign-in; created via + `POST /api/referrals/admin/vanity`). Andrew's edit: "(original song, not a cover band)". +- **Letter pages** (all 33 locales, shared `components/karaokehunt/KaraokeHuntLetter`): + `/karaokehunt` (A), `/karaokehuntlist` (B, PR #1045), `/karaokehuntnews` (C, PR #1046 + #1047). +- **SENDING METHOD (use this, not Gmail UI)**: Postmark API, **`outbound` stream**, HTML = Gmail + structure + Andrew's real signature captured from a Segment A message + (`outreach_out/segment_b_signature.{html,txt}`). This is the SAME path Segment A took (Gmail + send-as relays via Postmark SMTP → outbound). **Do NOT use the `broadcast` stream**: it forces a + Postmark unsubscribe footer + List-Unsubscribe header (Andrew disliked it — lands in his + unsubscribe filter); Custom unsubscribe handling needs Postmark support. Opt-out = "just reply". + Scripts: `outreach_out/segment_{b,c}_email.py`, `segment_b_run.py` (idempotent, paced 20/3min); + state in `segment_{b,c}_state.json`. urllib needs a curl User-Agent (Cloudflare WAF 1010). +- Engagement snapshot 09-24 ~12:00Z (Segment A): 30/87 opened, 7 clicked, 0 replies/bounces; + + clicked review links but never pressed "Complete Sign-In". +- Segment A recipient @ had previously DELETED their KH account (missed check). +- Remaining: engagement/replies for A+B+C → ~Oct 1 link re-mints → Oct 8 cleanup → Phase E + (Andrew: wait until after Oct 8) → `/backlog-finish` Frog #2 AND Frog #1. + +--- + +## 1. State (2026-09-24, after sends) + +- **ALL 87 Segment-A outreach emails SENT 2026-09-24** (04:12–05:53 UTC): batch 1 + (10) clicked Send by Andrew; remaining 77 sent by agent via Gmail UI (Andrew + approved one exemplar per message type, then authorized sending in 8 paced + batches of ~10 with ~6.5 min gaps). 0 failures; 0 KaraokeHunt drafts remain. +- All 90 generated jobs belong to their requesters; **karaokehunt@ holding account + CLEAR**. 55 complete/on YouTube; 35 parked awaiting requester review (34 skip-pile + + resubmitted Bhimsen 7a16be60). 1 already converted post-send ( → + BABYMONSTER FOREVER → NOMAD-1705 live ~06:59 UTC, 16 min after her click). +- **Hosted localized letter LIVE**: https://gen.nomadkaraoke.com/karaokehunt + (PR #1044, v0.238.1; bare URL locale-redirects; 33 locales; ThemeToggle localized; + no-JS fallback). Linked from every email's PS + native-language strip. +- **App-request interceptor LIVE** (v0.236.0) — new requests from old installs + auto-convert; nothing ongoing to do there. +- Early engagement (~11:15 UTC): **28/87 opened, 6 link clicks, 1 full conversion**. + +## 2. Deadlines / clocks + +- **~Oct 1**: the 35 one-click review links EXPIRE (minted 2026-09-24 ~04:00 UTC, + 168h = API max). If a recipient engages late, RE-MINT + reply/resend: + `POST /api/admin/users/{email}/login-link {"expiry_hours":168,"purpose":"job_review:"}` + (admin token from `admin-tokens` secret). Per-job links: `outreach_out/minted_links_2026-09-24.txt`. +- **~Oct 8 (2 weeks after send)**: CLEANUP SWEEP — Andrew's rule: parked jobs whose + requester took no action get cancelled/deleted (accounts + credits STAY). Check + `jobs` status + `gen_users.last_login_at` per recipient before deleting; record + outcomes in `phasec_state.json`. + +## 3. Engagement / reply monitoring (the "check engagement" recipe) + +Andrew's Gmail send-as relays via **Postmark SMTP → opens AND link clicks ARE +tracked** (do NOT assume plain Gmail = untracked; that was corrected 09-24). +- Postmark server token: Secret Manager `postmark-server-token`. +- Opens: `GET https://api.postmarkapp.com/messages/outbound/opens?count=500&offset=N` + · Clicks: `.../clicks` — filter `Recipient` against the 87 (recipient list = + `outreach_out/drafted_emails_2026-09-24.json` + the 10 batch-1 addresses in the + phase-c handoff). Timestamps are EDT (-04:00). +- Server-side: `gen_users/{email}.last_login_at` (docs keyed by EMAIL); + parked-job status flips in `jobs` (fleet ids in `batch_state.json`); + `total_jobs_created` for credit usage; /karaokehunt views via CF zone analytics. +- Replies/bounces: Andrew's Gmail (`in:inbox subject:KaraokeHunt` etc.). Triage: + - ** / reply for credits** → their + emails promised 3 credits on reply; grant via admin (the `/api/users/admin/credits` + endpoint EMAILS the user — fine once they've replied) or Andrew via admin UI. + - **Vague-request replies** (=Justin Bieber song?, =Arijit + song?, ="My songs") → they name a song → generate it for them (these are + legit requested songs, not "popular songs"). + - Bounced addresses → note in phasec_state, nothing else owed. + +## 4. NEXT STEPS, in order + +1. **Daily-ish engagement check + reply triage** (§3) until ~Oct 8. +2. **Oct 8 cleanup sweep** (§2). After it: zero/archive the karaokehunt@ account. +3. **Segment B (266 app-users-never-requested) & C (37 kit-buyers-only)**: + - Base drafts exist in `outreach_out/review_packet_bc.md` — REFRESH to the final + approved template (hyphens, Cheers/Andrew+signature, PS + language strip, + /karaokehunt link, credits offer). These are generic (no per-user songs). + - ⚠️ **C overlaps Frog #1 launch-email — reconcile to ONE offer with Andrew + BEFORE drafting C.** + - ⚠️ **Volume decision needed from Andrew for B**: 266 emails at ~10/day via + Gmail UI = ~4 weeks. Options: bigger daily batches, or send B via Postmark + broadcast stream (they're generic letters, not personal apologies) — ask him. +4. **GCP Phase E** (destructive — get Andrew's explicit go, his gcloud is authed): + `gcloud projects delete projectbread-karaokay` + close billing acct + `0123B3-AAC0D8-4344D3`. Play/App Store: apps unpublished; do NOT "Delete app". +5. **Close out**: `/backlog-finish` Frog #2 ("KaraokeHunt order-email recovery + app + redirect") → CHANGELOG; update memory `project_karaokehunt_batch_generation` + + MEMORY.md; `/cleanup` the outreach + letter worktrees when truly done. + +## 5. HARD-WON GOTCHAS (email automation via Gmail UI) + +- **Drafting/sending MUST go through the Gmail UI in playwright-chrome-3** (his + logged-in profile). The Gmail API/MCP cannot set the From alias and mangles + signature + links (google.com/url wrappers). +- Compose flow: Compose → From dropdown → andrew@nomadkaraoke.com (Gmail inserts his + real signature) → fill To/Subject → insert body with + `document.execCommand('insertText')` at a collapsed-to-start selection. + `fill()` WIPES the signature; `insertHTML` is blocked by Trusted Types. +- **Gmail SILENTLY DROPS saves under rapid scripted composing** (~56 of 77 lost on + the first pass). Always wait for the compose header's "Draft saved" ack before + Save & close, pace ≥1s, and VERIFY the drafts count grew after each chunk. +- Send = focus body + ⌘Enter; sending 10-batches with ~6.5 min gaps tripped no bot + protection. +- `getByRole('link', {name:/KaraokeHunt/})` matches the SIDEBAR LABEL "KaraokeHunt" + — scope row locators to `tr.zA` or match on full subjects. +- Gmail search does NOT reliably index fresh drafts (to:, body, or subject) — + operate on the #drafts folder rows, not search. +- Bulk automation: `browser_run_code_unsafe` with a script file under + `.playwright-mcp/kh-scripts/` (allowed root). Reusable scripts there: + `kh_send10.js` (send 10 oldest KH drafts), redo/draft chunk templates. +- Postmark 168h is the login-link expiry_hours MAX (422 above). +- Email content conventions (LOCKED): hyphens never em-dashes; original request + date in opening ("a while back (April 1st 2025)…", softened if <2 months); + NO bilingual bodies (PS strip + localized page instead); "Cheers,\nAndrew". + +## 6. Where everything lives + +Local PII dir (NEVER commit): `old-or-other/karaokehunt-users-export-2026-09-09/outreach_out/` +- `drafted_emails_2026-09-24.json` — full text of all 77 sent emails (with types). +- `minted_links_2026-09-24.txt` — email → job_id → one-click URL for the 35 parked. +- `batch_state.json` / `phasec_state.json` / `actions_v3.json` / + `language_inference.json` / `review_packet_bc.md` — as before (phase-c handoff §2). + +Docs: phase-c handoff (history), this doc (continuation), workspace session records +`docs/sessions/2026-Q3/2026-09-24-karaokehunt-segment-a-complete.md` (+ 09-19/09-22 ones). diff --git a/docs/sessions/2026-Q3/2026-09-19-karaokehunt-outreach-phase-c.md b/docs/sessions/2026-Q3/2026-09-19-karaokehunt-outreach-phase-c.md new file mode 100644 index 00000000..76649582 --- /dev/null +++ b/docs/sessions/2026-Q3/2026-09-19-karaokehunt-outreach-phase-c.md @@ -0,0 +1,56 @@ +# KaraokeHunt outreach — batch generation through Phase C — 2026-09-19 + +**Project:** karaoke-gen (worktree `karaoke-gen-karaokehunt-outreach`) +**Branch:** `feat/sess-20260913-0106-karaokehunt-outreach` (PRs #1004 #1005 #1015 #1016 merged from it) +**Status:** in-progress — handoff to fresh session + +## Summary +One long multi-day session (2026-09-13 → 09-19) that took the KaraokeHunt requester +outreach from analysis to near-completion: canonicalized all 139 requested songs +(InputURL-oEmbed + search evidence + web search), batch-generated 90 public karaoke +jobs under holding account karaokehunt@nomadkaraoke.com, ran the full-auto-review +experiment (13/89 ≈ 15% full-auto), triaged the rest for Andrew's review (15 easy + +26 medium done or in progress; 34 skip → users), shipped one-click authed review +links, reassigned 62 jobs to requester accounts (48 created silently with 3 credits), +and drafted the first Gmail outreach batch (10, NOT sent). + +## What changed +- **Prod jobs**: 90 jobs created (review_mode=auto, public, MFY=true); 39 complete/live + on YouTube as of wrap; 62 reassigned to requesters; 49 accounts exist. +- **karaoke-gen PRs shipped**: #1004 made_for_you admin-editable (stale-review + exemption); #1005 `POST /api/internal/jobs/{id}/auto-approval-eval`; #1015 admin + login-link mint endpoint with `job_review:` redirect purpose; #1016 verify-page + hard-navigation fix for hash redirect paths. All deployed + prod-verified. +- **Gmail**: 10 outreach drafts created in Andrew's account (batch 1, English, + completed-video variant). Nothing sent to anyone. +- **Ops incidents handled**: RED IP-ban of flacup (27 download failures, 100% + recovered via retry loop); encoding-worker disconnect (Buck Owens, retried); + Cloudflare-524 duplicate job (cancelled); tangled reset job (cancelled+resubmitted). + +## Decisions & rationale +- Holding-account pattern (karaokehunt@ + catchall) to contain ALL job emails until + coordinated outreach — worked perfectly. +- Relaxed torrent rule (Andrew): any FLAC ≥2 seeders with roughly-matching filename. +- Brand-only karaoke versions on KN → generate anyway (Andrew). +- Non-English / no-reference songs → skip Andrew's review; requesters self-review via + one-click links. +- Emails: Gmail drafts only, Andrew sends in ~10 batches (standing policy). + +## Learnings / gotchas +See §3 of `docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md` — the +authoritative list (MFY dual-role, /admin/credits emails users, RED burst bans, +CF-524 double-creates, retry vs reset semantics, KN never-scrape). + +## Open threads & next steps +**Pick up from `docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md`** — +it is the self-contained continuation doc: open the 16 remaining medium review tabs, +reassign newly-completed jobs, run the email batches (batch 1 awaiting Andrew's +review/send), bilingual + skip-pile batches with minted links, hosted localized +letter, Segments B/C (reconcile C with Frog #1), then final KaraokeHunt-era cleanup +(GCP Phase E delete, /backlog-finish Frog #2). + +## Related docs +- `docs/archive/2026-09-19-karaokehunt-outreach-phase-c-handoff.md` (CONTINUATION) +- `docs/archive/2026-09-13-karaokehunt-outreach-handoff.md` (full history, sessions 1–5) +- Memory: `project_karaokehunt_batch_generation`, `feedback_outreach_email_sending_policy` +- Local PII data: `old-or-other/karaokehunt-users-export-2026-09-09/outreach_out/`