From a4c5b24f2062855660f1b5b759de6aa29e34fdd1 Mon Sep 17 00:00:00 2001 From: Sam Rolfe Date: Sun, 11 Oct 2026 19:53:02 +1100 Subject: [PATCH] Add prominent Gmail build callouts to AGENTS.md Call out two facts that already caused a confusing failure, before the build phases begin: 1. Force IPv4 for every Gmail connection (IMAP and SMTP). 2. The source address header is X-Pm-Original-To; never use Delivered-To. Additive only. No FR id, phase id, or other section is changed. Co-Authored-By: Paperclip --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f911033..dc12d36 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,6 +5,19 @@ --- +## Critical build callouts + +Read these two facts before you start a build phase. They already caused a +confusing failure once. + +1. **Force IPv4 for every Gmail connection.** This applies to IMAP and SMTP. + See §9 and the infrastructure notes. The first IMAP attempt failed with a + socket EOF over IPv6 from `.13`. +2. **The source address header is `X-Pm-Original-To`** (added by PurelyMail). + See FR-2 and §13.7. **Never use `Delivered-To`** — Gmail overwrites it. + +--- + ## 1. Purpose and outcome A web app that triages the family inbox. All mail lands in one Gmail account