[gmail-safety-and-standards-hardening] #05: Decouple IMAP Protocol Extension Codecs #24

New issue

Closed

opened 2026-08-28 17:32:18 +03:00 by jalmari · 1 comment

jalmari commented

2026-08-28 17:32:18 +03:00

Owner

Feature: gmail-safety-and-standards-hardening | Source: .scratch/gmail-safety-and-standards-hardening/issues/05-decouple-imap-extension-codecs.md

05: Decouple IMAP Protocol Extension Codecs

What to build: Extract pure IMAP text decoding for X-GM-MSGID and X-GM-LABELS out of gateway.py and into codecs.py (parse_gmail_msgid and parse_gmail_labels) to strictly adhere to ADR-0004.

Blocked by: None (can start immediately)

Status: ready-for-agent

Implement parse_gmail_msgid(response_str: str) -> str in src/mailsweep/codecs.py.
Implement parse_gmail_labels(response_str: str) -> tuple[str, ...] in src/mailsweep/codecs.py.
Refactor MailboxGateway.fetch_headers() in src/mailsweep/gateway.py to use these pure codec functions.
Add unit tests in test_mailsweep.py verifying parsing of plain labels, quoted labels, system flags, and empty responses.

**Feature**: `gmail-safety-and-standards-hardening` | **Source**: `.scratch/gmail-safety-and-standards-hardening/issues/05-decouple-imap-extension-codecs.md` # 05: Decouple IMAP Protocol Extension Codecs **What to build:** Extract pure IMAP text decoding for `X-GM-MSGID` and `X-GM-LABELS` out of `gateway.py` and into `codecs.py` (`parse_gmail_msgid` and `parse_gmail_labels`) to strictly adhere to ADR-0004. **Blocked by:** None (can start immediately) **Status:** ready-for-agent - [ ] Implement `parse_gmail_msgid(response_str: str) -> str` in `src/mailsweep/codecs.py`. - [ ] Implement `parse_gmail_labels(response_str: str) -> tuple[str, ...]` in `src/mailsweep/codecs.py`. - [ ] Refactor `MailboxGateway.fetch_headers()` in `src/mailsweep/gateway.py` to use these pure codec functions. - [ ] Add unit tests in `test_mailsweep.py` verifying parsing of plain labels, quoted labels, system flags, and empty responses.

jalmari added the

ready-for-agent

feature

labels

2026-08-28 17:32:18 +03:00

jalmari added a new dependency

2026-08-28 17:32:32 +03:00

#22 [gmail-safety-and-standards-hardening] #03: All Mail Discovery & Fallback

jalmari added a new dependency

2026-08-28 17:32:32 +03:00

#23 [gmail-safety-and-standards-hardening] #04: Documentation & CONTEXT Synchronization

jalmari commented

2026-08-28 18:32:34 +03:00

Author

Owner

Completed in commit 58928fe.

Implemented parse_gmail_msgid(response_str: str) -> str in src/mailsweep/codecs.py.
Implemented parse_gmail_labels(response_str: str) -> tuple[str, ...] in src/mailsweep/codecs.py with full RFC 3501 quoted string support.
Refactored MailboxGateway.fetch_headers() in src/mailsweep/gateway.py to use pure codec functions.
Added unit test coverage in test_mailsweep.py verifying plain labels, quoted labels, system flags, and empty responses.
107/107 tests passing.

Completed in commit `58928fe`. - Implemented `parse_gmail_msgid(response_str: str) -> str` in `src/mailsweep/codecs.py`. - Implemented `parse_gmail_labels(response_str: str) -> tuple[str, ...]` in `src/mailsweep/codecs.py` with full RFC 3501 quoted string support. - Refactored `MailboxGateway.fetch_headers()` in `src/mailsweep/gateway.py` to use pure codec functions. - Added unit test coverage in `test_mailsweep.py` verifying plain labels, quoted labels, system flags, and empty responses. - 107/107 tests passing.

jalmari closed this issue

2026-08-28 18:32:34 +03:00

jalmari referenced this issue from a commit

2026-08-28 18:40:59 +03:00

refactor(codecs): decouple IMAP protocol extension codecs (Closes #24)