---

name: delete-episode description: Delete podcast episodes from the TTS system. Use when asked to delete, remove, or clean up an episode from a podcast feed.

Delete Episode

Deleting an episode requires cleanup in three places.

Where Episodes Live

1. Hub database - Source of truth. Query via Kamal console from the hub directory.
2. Google Cloud Storage - MP3 file, manifest.json, feed.xml
3. RSS feed - Regenerate after manifest update so podcast apps reflect the change

Key Relationships

From a Hub Episode record:

• episode.podcast.podcast_id → GCS folder name (e.g., podcast_106f7e1301ae9fc2)
• episode.gcs_episode_id → MP3 filename (without .mp3 extension)

GCS Structure

Copygs://verynormal-tts-podcast/podcasts/{podcast_id}/
├── episodes/{gcs_episode_id}.mp3
├── manifest.json
└── feed.xml

RSS Regeneration

After updating manifest.json, regenerate feed.xml using:

• RSSGenerator class from the tts lib directory
• Podcast config from config/podcast.yml
• Episodes array from the updated manifest

Constraints

• Confirm before deleting - Show episode title, podcast, date, and ask for confirmation
• Multiple matches - If search finds multiple episodes, list all with details and ask which one
• Stop on failure - If any step fails, report what succeeded and what failed. Don't continue.

Deletion Order

1. Delete MP3 from GCS
2. Update manifest.json (remove episode entry)
3. Regenerate and upload feed.xml
4. Delete episode from Hub database