KofTwentyTwo/nuncio
2
0 Fork 0
Code Issues 73 Pull Requests 12 Actions Packages Projects Releases Wiki Activity

mail: raw IMAP command layer for ENABLE, tagged response codes, and VANISHED #388

New Issue
Open
opened 2026-08-10 19:27:50 +00:00 by KofTwentyTwo · 0 comments
KofTwentyTwo commented 2026-08-10 19:27:50 +00:00 (Migrated from github.com)
Copy link
Copy source

Dependency gate for change enumeration and verified mutations. Decide fork vs hand-roll here.

async-imap 0.11.3 cannot express any of the primitives the sync model needs:

Needed Status
ENABLE no command at all — RFC 7162 §3.2.3 requires it before QRESYNC or the server MUST reply BAD
SELECT (QRESYNC …) no select_qresync
VANISHED parsed by imap-proto but dropped by async-imap's select() parser
COPYUID uid_copy/uid_mv return Result<()>; check_status_ok discards the response code
[MODIFIED …] no UNCHANGEDSINCE variant; tagged code discarded

run_command/read_response are public, so a hand-rolled tagged-response collector is viable (~80–150 LOC plus per-command parsers), subject to the workspace -D warnings / no-unwrap regime. The alternative is forking async-imap.

Do not freeze nuncio.v1 until this path is proven.

Testable against the harness in #384.

Design: ADR 0002 · review evidence (PR #385)

**Dependency gate for change enumeration and verified mutations. Decide fork vs hand-roll here.** `async-imap` 0.11.3 cannot express any of the primitives the sync model needs: | Needed | Status | | --- | --- | | `ENABLE` | no command at all — RFC 7162 §3.2.3 requires it before QRESYNC or the server MUST reply BAD | | `SELECT (QRESYNC …)` | no `select_qresync` | | `VANISHED` | parsed by `imap-proto` but dropped by async-imap's `select()` parser | | `COPYUID` | `uid_copy`/`uid_mv` return `Result<()>`; `check_status_ok` discards the response code | | `[MODIFIED …]` | no `UNCHANGEDSINCE` variant; tagged code discarded | `run_command`/`read_response` are public, so a hand-rolled tagged-response collector is viable (~80–150 LOC plus per-command parsers), subject to the workspace `-D warnings` / no-`unwrap` regime. The alternative is forking `async-imap`. **Do not freeze `nuncio.v1` until this path is proven.** Testable against the harness in #384. Design: [ADR 0002](https://github.com/KofTwentyTwo/nuncio/blob/dev/docs/adr/0002-multi-engine-sync-model.md) · [review evidence](https://github.com/KofTwentyTwo/nuncio/blob/dev/docs/reviews/2026-08-10-multi-engine-design-review.md) (PR #385)
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
area-ci
CI / quality gates
 area-cli
nuncio-cli reference client
 area-docs
Documentation
 area-grpc
gRPC API layer
 area-mail
Mail protocols
 area-release
Release / packaging
 area-security
Security
 area-store
Storage / SQLite
 bug
Something isn't working
 deferred
Backlog, off the critical path; re-justify before scheduling
 dependencies
Pull requests that update a dependency file
 documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 github_actions
Pull requests that update GitHub Actions code
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 javascript
Pull requests that update javascript code
 phase-0
Roadmap Phase 0
 phase-1
Roadmap Phase 1
 phase-2
Roadmap Phase 2
 phase-3
Roadmap Phase 3
 phase-4
Roadmap Phase 4
 phase-5
Roadmap Phase 5
 question
Further information is requested
 rust
Pull requests that update rust code
 story
Roadmap story: full LLM-ready spec, done via engine+proto+CLI+E2E
 wontfix
This will not be worked on
No labels area-mail story
Milestone
No items
No Milestone WS-C: Sync, push & lifecycle
Projects
Clear projects
No projects
Assignees
Clear assignees
forge-recovery (Forge Recovery) james.maes (James Maes)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: KofTwentyTwo/nuncio#388