mirror of
https://github.com/nomadkaraoke/karaoke-gen.git
synced 2026-11-20 13:07:57 +09:00
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:
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/`
|
||||
Reference in new issue
Block a user