Newsletter Voice Standardization + Content-Quality Audit — 2026-05-21

Owner: TITAN · Status: Phase 1 shipped (voice unified, guards in place), Phase 2 = first live run.

Decisions (Harnoor, 2026-05-21)

1. Template standard = comic rotation (the current Agent Stack look).

2. Agent Stack = commercial flagship; OpenClaw / Agentic-AI / Claude weeklies stay as free feeders.

3. Audio format = two-host NotebookLM-style dialogue (ALEX + MAYA), via newsletter_to_audio.py.

Problem found (the "fix inconsistencies with playing voice" ask)

Voice playback was fragmented across 7 mechanisms:

3 TTS pipelines → 3 S3 prefixes: newsletter_to_polly (Polly Ruth), newsletter_to_audio (Gemini 2-host), newsletter_narrator (Sonnet+Polly).
2 email embeds: bare MP3 link (_audio_banner) vs. persona player banner (_player_banner).
A heavy "Jarvis HUD" hosted player page.
2 host URLs (one stale: play.silentinfinity.com vs titan.livegroweveryday.com/play).
No clean Google-Podcasts-style inline widget anywhere.

What shipped (this pass)

newsletter_player.py (NEW) — the ONE canonical player. inline_player_html() = clean

Google-Podcasts widget (cover, play/pause, scrubber, current/total time, ±15s, 1×/1.25×/1.5×/2×

speed). email_card_html() = email-safe card (cover + native <audio controls> + "Open full

player" link). Cool-blue brand (#6aa9ff, dark cards). Verified live in Chrome — playback works.

build_player_page.py — HUD page replaced with the clean widget + issue rendered below;

polly_url param now carries the two-host MP3; dialogue pre-warm removed (redundant).

titan_email.py — both old banners replaced by the single email_card_html; legacy kept

only as fail-soft fallback.

All 4 newsletter callers (agent_stack_daily, openclaw_/agentic_ai_/claude_newsletter)

now use ONE audio path: newsletter_to_audio (2-host) → build_player_page. The parallel Polly

player path is retired.

Agent Stack SKILL — TITAN_NEWSLETTER_VARIETY turned OFF (locks the comic template as the

standard); TITAN_NEWSLETTER_AUDIO=1 explicit.

Content-quality guards

(a) News-only — is_news_item() in agent_stack_daily.py: requires a real external

source_url (rejects our own domains), drops infrastructure/promo/self kinds, requires

headline+summary. No news today → no send (filler self-promo seed removed).

(b) No repeats — cross-issue dedup via newsletter_ledger.find_eligible / mark_sent

(SQLite, shared across all 4 newsletters). Verified present and wired.

(c) Recurring segments once — rich callouts (joke / tip / snippet) gating fixed from

on-by-default (!= "0") to == "1", so they render exactly once per issue and never alongside

the legacy single-callout block. daily_callouts is deterministic per (slug+date) = one joke/tip

per issue, and different across the day's newsletters.

Verified

All 7 edited scripts byte-compile clean.
is_news_item unit check: real news kept, self-promo + no-URL dropped.
Dry render of Agent Stack email: card present, exactly one "Joke of the day", news-only.
Player page + email card published to s3://innerverse-voice-scratch/player/_test/ → HTTP 200,

real MP3 streams, play/pause confirmed in Chrome.

Production-readiness — remaining before commercial launch

[ ] First real scheduled run with TITAN_NEWSLETTER_AUDIO=1 generating a fresh 2-host MP3

(cost: Gemini TTS via deepdive, ~$2-3/issue — confirm budget cadence; daily = ~$60-90/mo).

[ ] Map titan.livegroweveryday.com/play (or a play.silentinfinity.com) CloudFront → the

player/ S3 prefix so the email "Open full player" link resolves on a branded domain.

[ ] Anti-repeat memory for jokes/tips across days (currently can repeat over time).
[ ] Subscribe/commercial: pricing + signup for the Agent Stack flagship (separate workstream).
[ ] Apply the same inline player to webpages that host recorded audio (Innerverse live-orb is a

separate real-time paradigm — left as-is).

Refinement pass (2026-05-21, testing on real 05-19/05-20 indexes)

Two production defects found by rendering real issues and fixed:

Flagship was starving — the indexer emits all 4 topics but each day only some;

agent-stack was frequently empty. agent_stack_daily.load_research_for_date now pulls

across ALL topics (agent-stack-native first, then by freshness) — the flagship is genuinely

cohesive/cross-topic.

Aggregator spam — crescendo.ai/news/latest-ai-news-and-updates was cited 8× in one day.

New shared module newsletter_quality.py (is_quality_source + cap_per_source) blocks

aggregator/landing pages (crescendo, google news, github/trending, /tag//category/ etc.),

requires a specific article path, and caps ≤2 stories per domain. Wired into ALL 4 newsletters

(Agent Stack via is_news_item; openclaw/agentic/claude in their gather()).

Verified on real data: 05-19 raw14→quality5→capped3; 05-20 raw16→quality7→capped5 (never empty).
All 4 newsletters render with exactly 1 joke/issue confirmed.

Key files

F:/TITAN/scripts/: newsletter_player.py, build_player_page.py, titan_email.py,

agent_stack_daily.py, openclaw_newsletter.py, agentic_ai_newsletter.py, claude_newsletter.py,

newsletter_templates.py, newsletter_to_audio.py, newsletter_ledger.py, daily_callouts.py.