Email IMAP Append

Core Goal

• Build RFC 5322 draft messages with subject/body/recipients.
• Attach local files into draft MIME payload when requested.
• Append the draft MIME into an IMAP mailbox using APPEND.
• Set draft flags (default \\Draft) and keep the message unsent.
• Return machine-readable JSON with append status and server response metadata.

Workflow

1. Configure IMAP env vars (see references/env.md and assets/config.example.env).
2. Validate config and defaults:

python3 scripts/imap_append.py check-config

3. Append one draft email to Drafts mailbox: