feat(bin): add IMAP/SMTP mail plane with standing poll - #3765

Merged

kunchenguid merged 74 commits into

kunchenguid:mainfrom

feilipu:fm/ship-bin-fm-mail-sh-email-plane-through-a4

Sep 9, 2026

Commits on Sep 9, 2026

feat(bin): add generic mail plane for reading and sending mail

firstmate crew
authored and
Phillip
committed
f46e9f5
fm-mail: productionize mail plane surface (shellcheck + fm-lint clean)

firstmate crew
authored and
Phillip
committed
e46e930
no-mistakes(review): Fix run_py exit code propagation and poll error handling in fm-mail.sh

firstmate crew
authored and
Phillip
committed
723f307
fm-mail: use IMAP UIDs, filter UNSEEN, and keep full poll set

firstmate crew
authored and
Phillip
committed
498f538
fm-mail: track mailbox generation, preview HTML mail, serialize polls

firstmate crew
authored and
Phillip
committed
08ddb31
fm-mail: keep poll cursor updates inside the flock window

firstmate crew
authored and
Phillip
committed
a189ef8
fm-mail: commit the cursor before emitting the wake

firstmate crew
authored and
Phillip
committed
6401119
fm-mail: emit the wake first, then record the uid

firstmate crew
authored and
Phillip
committed
6ae2ce3
fm-mail: make wake emission exactly-once against the fleet drain

firstmate crew
authored and
Phillip
committed
097a1f9
fm-mail: commit wake append and journal under one queue lock

firstmate crew
authored and
Phillip
committed
0c327d4
fm-mail: commit the cursor under the wake-queue lock

firstmate crew
authored and
Phillip
committed
68507de
mail: roll back a queued wake when no durable record lands

pilumnus
authored and
Phillip
committed
c506391
mail: durably record a wake when the rollback rewrite also fails

firstmate crew
authored and
Phillip
committed
e3aa5d8
mail: add standing received-mail check with arm/disarm and a poll error to stderr

firstmate crew
authored and
Phillip
committed
b6e5725
docs: document the mail-plane .env schema and standing mail check

firstmate crew
authored and
Phillip
committed
cd8f05a
no-mistakes(review): Remove unused FM_MAIL_TO reply-target config

firstmate crew
authored and
Phillip
committed
e58688f
no-mistakes(document): Align mail-plane docs with shipped behavior

firstmate crew
authored and
Phillip
committed
de67166
no-mistakes(lint): Re-ran lint; ShellCheck and actionlint clean

firstmate crew
authored and
Phillip
committed
e0e81bc
mail: journal-first wake emission and portable poll locking

firstmate crew
authored and
Phillip
committed
676d331
mail: bound wake volume, sanitize headers, drop stray actionlint binary

firstmate crew
authored and
Phillip
committed
3e4ddf1
mail: extract python engine and flatten the poll shape

firstmate crew
authored and
Phillip
committed
1293d33
mail: avoid per-message subshell forks in the poll loop

firstmate crew
authored and
Phillip
committed
442e8e0
mail: document the bounded kill-window duplicate residual

firstmate crew
authored and
Phillip
committed
659ceab
mail: honor env-over-.env and strip header whitespace

firstmate crew
authored and
Phillip
committed
7b3b03f
mail: scan a bounded window so an unfetchable uid cannot starve later mail

firstmate crew
authored and
Phillip
committed
17c3494
mail: surface unfetchable messages degraded instead of skipping them

firstmate crew
authored and
Phillip
committed
9daff5c
mail: keep heal evidence on failure and fix empty-plain preview fallback

firstmate crew
authored and
Phillip
committed
e905669
mail: fail closed on heal, load wake lib from script dir

firstmate crew
authored and
Phillip
committed
0f546f3
mail: retry transient fetch failures until real metadata lands

firstmate crew
authored and
Phillip
committed
4f9b124
mail: rotate failed retry uids so the scan always advances

firstmate crew
authored and
Phillip
committed
168b9e3
mail: unify helper naming across the plane

firstmate crew
authored and
Phillip
committed
b988a19
mail: reserve a retry budget and record retries before the wake

firstmate crew
authored and
Phillip
committed
e1b34e6
mail: keep retry and new-mail slots independent of the fetch window

firstmate crew
authored and
Phillip
committed
41953b9
fm-mail: heal rollback journal before the wake row; survive a raised per-uid FETCH

firstmate crew
authored and
Phillip
committed
28af9e0
fm-mail: scan the retry set with a durable advancing cursor, not a rotation

firstmate crew
authored and
Phillip
committed
1e8c4aa
fm-mail: alternate a single contended wake slot between new mail and retry recovery

firstmate crew
authored and
Phillip
committed
169ff96
fm-mail: keep a degraded uid retryable when its wake fails to record

firstmate crew
authored and
Phillip
committed
7229dcb
fm-mail: fail closed on retry-state write failures instead of degrading fairness

firstmate crew
authored and
Phillip
committed
3a447a4
fm-mail: fail the poll cleanly on a poll_list failure instead of aborting mid-lock

firstmate crew
authored and
Phillip
committed
3fca48f
fm-mail: restore a recovered uid's retry when its wake delivers nothing

firstmate crew
authored and
Phillip
committed
5c38157
fm-mail: fail closed on stale retry clear; define assert_equals

firstmate crew
authored and
Phillip
committed
dadcbd7
fix: apply combined Greptile fixes for PR 3765 wake transaction

firstmate crew
authored and
Phillip
committed
36cbdea
fix(bin): genuine mail-record failure detection, read hardening, and regression tests

firstmate crew
authored and
Phillip
committed
15ac84a
fix(bin): emit retry rows before persisting retry-scan position

firstmate crew
authored and
Phillip
committed
c1db3c6
fix(bin): self-healing fallback when retry restore fails after a rolled-back recovery wake

firstmate crew
authored and
Phillip
committed
183ecb6
no-mistakes(document): Align mail-plane docs with shipped poll behavior

firstmate crew
authored and
Phillip
committed
260c1e9
no-mistakes(review): Logout and flush before persisting retry position

firstmate crew
authored and
Phillip
committed
8888a21
no-mistakes(review): Skip wake lines in failed poll summaries

firstmate crew
authored and
Phillip
committed
e1a0a35
fix(bin): move retry clear into wake_for to close kill-window strand

firstmate crew
authored and
Phillip
committed
1dd8f90
no-mistakes(review): Prevent duplicate retry wakes and skipped windows
Phillip
committed
a826fa7
no-mistakes(review): Stop tagged journal from poisoning cursor
Phillip
committed
de0646a
fix(bin): never cursor-record a mail without journal evidence

firstmate crew
authored and
Phillip
committed
972c656
fix(bin): advance retry-scan position by budget-examined candidates

firstmate crew
authored and
Phillip
committed
2e2a21f
fix(bin): a retry window of unseen uids can never stall the cursor

firstmate crew
authored and
Phillip
committed
2d356e1
no-mistakes(document): Align mail-engine docs with poll side effects
Phillip
committed
2c90804
no-mistakes(document): Fix stale mail-plane owner comments
Phillip
committed
de83b2b
fix(bin): rotate small retry window and harden poll persist ordering in fm-mail.py

firstmate crew
authored and
Phillip
committed
dde9e29
fix(bin): advance retry-scan position under new-mail flood in fm-mail.py

firstmate crew
authored and
Phillip
committed
269f3ae
no-mistakes(document): Drop stale mail retry-scan advance comments
Phillip
committed
adfb94a
fix(bin): emit a wake line when a mail poll surfaces new mail

firstmate crew
authored and
Phillip
committed
76e0c66
no-mistakes(review): Align mail-check tests and docs with wake line

firstmate crew
authored and
Phillip
committed
79ce1cb
no-mistakes(document): Align mail-check report docs with findings

firstmate crew
authored and
Phillip
committed
ca0d0ab
fix(bin): still wake on a repeated mail-check failure that queued mail

firstmate crew
authored and
Phillip
committed
db0c184
no-mistakes(document): Drop stale mail-check once-per-finding claim

firstmate crew
authored and
Phillip
committed
0ca272d
fix(bin): always wake on a mail-check timeout

firstmate crew
authored and
Phillip
committed
33e59be
no-mistakes(review): Align mail-check timeout docs with always-print

firstmate crew
authored and
Phillip
committed
9e8544d
fix(bin): doorbell mail-check unless the poll is a proven no-op

firstmate crew
authored and
Phillip
committed
60a9886
no-mistakes(review): Drop heal diagnostic from publication evidence

firstmate crew
authored and
Phillip
committed
dc06d95
no-mistakes(document): Align mail-check docs with proven no-op

firstmate crew
authored and
Phillip
committed
4f82aeb
fix(tests): silence unused out3 in retry-scan poll (SC2034)

firstmate crew
authored and
Phillip
committed
6a44a4c
test(mail): dump poll output when recovered fetch poll fails

firstmate crew
authored and
Phillip
committed
cf73bb6
no-mistakes(document): Align mail-plane docs with retry recovery
Phillip
committed
60f55ad
no-mistakes(ci): CI failed on tests/fm-mail.test.sh: recovered fetch poll exited 1 with no poll output (run 34305650305, portable serial 4). mail_poll split the generation guard with printf|head -n…
Phillip
committed
1f5d46d
no-mistakes(review): Persist retry-pos before turn; logout on IMAP errors
Phillip
committed
61d2660