Files
agent-estate-wiki/incidents/2026-08-29-gmail-read-state.md
T

104 lines
4.9 KiB
Markdown

---
title: "Gmail Read-State Incident (2026-08-29)"
type: incident
status: active
created: 2026-08-29
updated: 2026-10-20
verified_on: 2026-10-20
confidence: high
tags: [email, gmail, cron, himalaya, incident]
sources: [session:default/20260829_204103_9e1087]
---
# Gmail Read-State Incident
**Date discovered:** 2026-08-29 20:41 AWST
**Status:** Active — mitigation in place, root cause identified but not fully fixed
## Summary
Anthony's Gmail inbox messages were being automatically marked as read without his consent. The issue was traced to Hermes cron jobs using Himalaya's `message read` command, which applies the "seen" flag even with `--preview`.
## Timeline
- **2026-08-29 20:41** — Anthony reports: "What is marking my Gmail email as read it is not meant to be"
- **Investigation** — Loaded skills: `gmail-imap-email-monitor`, `hermes-cron-operations`, `email-inbox-triage`
- **Root cause identified** — `fetch_newsletters.py` (line 49) runs:
```bash
himalaya message read --preview --folder INBOX <message-id>
```
Himalaya's `message read` command **automatically applies the "seen" flag** unless `--preview` is used for preview-only access. However, even `--preview` may still mark messages read in some configurations.
- **Other scripts checked** — `gmail_readonly_imap.py` uses `SELECT readonly` and `BODY.PEEK[]` (safe, does not mark read)
- **Mitigation applied:**
- Stopped `goimapnotify.service` (IMAP watcher)
- Paused "Important-mail monitor" cron job (if present)
- Newsletter digest already patched to use `--preview`
## Root Cause
The `fetch_newsletters.py` script at `/home/hermes/.hermes/scripts/fetch_newsletters.py` line 49:
```python
r2 = subprocess.run(
["himalaya", "message", "read", "--preview", "--folder", "INBOX", m["id"]],
capture_output=True, text=True, timeout=60
)
```
Despite using `--preview`, Himalaya may still mark messages as read depending on configuration. The proper fix is to use readonly IMAP with `BODY.PEEK[]` instead of the `himalaya message read` command.
## Impact
- Newsletter emails processed by the Tech & AI Newsletter Digest cron job were marked as read
- Potential for other Gmail automation scripts to have similar behavior
- User trust issue — unexpected state changes in personal email
## Resolution Status
**Mitigation:** Partially complete
- `goimapnotify` stopped
- Important-mail monitor paused (if it existed)
> **Re-verified 2026-10-20 — the mitigation has partially REGRESSED, and the root cause is still
> live.**
>
> | Item | State on 2026-08-29 | State on 2026-10-20 |
> |---|---|---|
> | `goimapnotify.service` | stopped | **ACTIVE again** — `systemctl --user is-active goimapnotify.service` → `active`, PID 383 `/home/hermes/go/bin/goimapnotify -conf /home/hermes/.config/goimapnotify/goimapnotify.yaml` |
> | Important-mail monitor (`d40085da631c`) | paused | **still paused** — `enabled: False` in `jobs.json`, `last_status: ok` |
> | `fetch_newsletters.py` line 49 | patched to `--preview` | **still `himalaya message read --preview --folder INBOX`** — the unsafe call is still in the file, unfixed |
>
> **So the real fix — rewriting `fetch_newsletters.py` to use readonly IMAP (`SELECT readonly` /
> `BODY.PEEK[]`) — has still not been done 52 days later.** The two mitigations that were applied
> are one of them gone (goimapnotify restarted) and one still holding (the important-mail monitor
> remains disabled).
>
> **Other email crons currently in `error` state (2026-10-20 read of `jobs.json`):**
> `85edf6772bca` Tech & AI Newsletter Digest, `08eb86f02d37` Gmail Action Digest,
> `06a0a1c8704f` AI Newsletter Curation for Patrick. Their most recent failures were
> provider-side (OmniRoute 503 resource pressure on 2026-10-19; a connection error on 2026-10-15),
> **not** read-state errors — but the read-state exposure persists regardless, because the
> newsletter fetch path still issues `message read`.
>
> **Recommended action (not taken here — this is a wiki job, and the fix touches Anthony's mail):**
> rewrite `fetch_newsletters.py` to use readonly IMAP, and decide whether `goimapnotify` should be
> running. See [[systems/scheduled-tasks]] and the Gmail IMAP lessons in
> [[runbooks/provider-health]].
**Fix required:**
- Rewrite `fetch_newsletters.py` to use readonly IMAP (`BODY.PEEK[]`) instead of `himalaya message read`
- Audit all Gmail-related scripts for similar patterns
- Verify `gmail_action_digest_v3.py` and other email scripts use readonly access
## Related Pages
- [[systems/scheduled-tasks]] — Tech & AI Newsletter Digest cron job
- [[systems/messaging-integrations]] — Email integration patterns
- [[runbooks/job-radar]] — Email monitoring patterns (for reference)
## Prevention
- All Gmail IMAP scripts should use `SELECT readonly` and `BODY.PEEK[]` patterns
- Add a pre-commit check or linting rule for `himalaya message read` usage
- Document readonly email access pattern in a runbook