fix(orchestrator): prevent concurrent double-run duplicating messages; reflect errors in status

2026-07-01 19:32:04 +07:00
parent 1373aa0a77
commit 2429c786e4
6 changed files with 72 additions and 4 deletions
@@ -78,6 +78,14 @@ bash scripts/e2e.sh
 # or: make e2e
 ```

+## Known limitations
+
+Deduplication key is `UNIQUE(account_id, message_key)` **without folder**. If
+the same message appears in multiple source folders (e.g. Gmail `INBOX` +
+`[Gmail]/All Mail` + labels-as-folders), it is copied only into whichever
+destination folder is processed first; folder placement for such duplicated
+messages is not guaranteed. This is intentional per the design spec.
+
 ## Architecture

 - `cmd/server` — entrypoint: runs DB migrations, then serves HTTP.