docs: KaraokeHunt outreach handoffs + session record (#1048)

Docs-only. Brings the KaraokeHunt outreach handoff docs (2026-09-13,
09-19, 09-24 final phase) and the 09-19 session record onto main before
the outreach worktree is cleaned up. Covers Segments A/B/C being sent
(87 + 238 + 35) and the Postmark outbound-stream sending method.

This is a public repo, so customer emails and handles are redacted to
`<user>`. The unredacted working copies stay in the local PII directory.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Andrew Beveridge ☄️andClaude Opus 5.5 authored and GitHub committed 2026-09-24 19:37:12 -04:00
1 parent 6c28a8cc3c
commit daa46347f7
4 files changed
+408

No files matched your search

@@ -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:<id>"}`
> → 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; <user>@ 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 →
@@ -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`; <user> =
`exists_via_interceptor_no_silent_credits` — mention credits in their email; same for
<user>).
**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: <user> he, <user> it, <user> es, <user> es, <user> 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', '<admin token>')`
(token: `gcloud secrets versions access latest --secret=admin-tokens --project=nomadkaraoke | cut -d',' -f1`).
Review URL: `https://gen.nomadkaraoke.com/app/jobs#/<job_id>/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:<job_id>"}`
(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**
(<user> 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): <user>, <user>, <user>,
<user>, <user>, <user>, <user>, <user>,
<user>, <user>. 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:<their job_id>`, 168h). Users get their 3 credits
mentioned. Requesters with BOTH complete + pending songs (<user>,
<user>, <user>, <user>, <user>) 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 <user> (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. <user> ~15 songs, <user>,
<user>, <user>, hello@thepropervolume) — email each ONCE when their
whole set resolves; their skip-pile songs get one-click links in the same email.
@@ -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 (<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;
<user> + <user> clicked review links but never pressed "Complete Sign-In".
- Segment A recipient <user>@ 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 (<user> →
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:<job_id>"}`
(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:
- **<user> / <user> 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** (<user>=Justin Bieber song?, <user>=Arijit
song?, <user>="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).
@@ -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:<id>` 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/`