Add mavmaild, the read-only IMAP poller that feeds mail intake (#246)

kami/Maven

The extraction seam landed on the previous branch but nothing fed it. This
adds the daemon that does: every interval it opens one mailbox read-only
(EXAMINE + BODY.PEEK, so reading leaves no \Seen behind), fetches the UIDs
it has not handed over yet, and posts each message to core over
ingest_mail. Core runs the model and writes task candidates; this daemon
writes nothing and cannot create a reminder.

It is a separate daemon because of the credential. mavpoll set the
precedent with the zenmoney token (#125): the module talking to the third
party holds the secret, reads it from a file so it never lands in argv, in
docker-compose.yml or in shell history, and core never sees it. There is
deliberately no -password flag, and a test asserts that.

Off unless configured at both ends: without -password-file the daemon
refuses to start, and if core has no email block the first ingest returns
ErrUnknownMethod, which disables the reader instead of hammering a socket
that will keep refusing. A seen-UID state file (0600, atomic write) keeps a
restart from re-extracting the whole lookback window; correctness does not
depend on it, since capture dedupes on normalised text. Logs are counts and
UIDs — no subject, sender or body.

Verified with an in-process IMAP server and a fake core: bulk mail is
filtered before core is asked, seen UIDs are not re-fetched, a failed
ingest is retried next poll, ErrUnknownMethod stops at the first message,
and state survives a restart. The live half is untested by design — no IMAP
credential exists on this box; setup is written up as QA steps.

Vikunja #246

This commit is contained in:

kami

2026-08-01 03:13:18 +04:00

parent f42d1594ef

commit ee7bec11e3

9 changed files with 636 additions and 16 deletions

									
										Dockerfile
									
		+2
		-1
	
												View File
												
				@@ -51,7 +51,8 @@ RUN go build -o /out/mavend    ./cmd/mavend    && \

				    go build -o /out/mavttsd   ./cmd/mavttsd   && \

				    go build -o /out/mavweb    ./cmd/mavweb    && \

				    go build -o /out/mavpoll   ./cmd/mavpoll   && \

				    go build -o /out/mavcaldav ./cmd/mavcaldav

				    go build -o /out/mavcaldav ./cmd/mavcaldav && \

				    go build -o /out/mavmaild  ./cmd/mavmaild

				# llama.cpp Vulkan build — the phraser/router LFM engine (llama-server). Built

				# from source (not a prebuilt vendored blob) so the binary's glibc/GLIBCXX match