@wirecat/cli-core 0.490.0 → 0.491.0

package/CHANGELOG.md

@@ -5,7 +5,14 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.491.0 — 31.10.2026
+
+### Fixed
+
+- **A budgeted mail sync now finishes locating a large folder stored before email locations existed.** It listed
+  the same newest messages every run, so a 16,100-message INBOX never got every UID stored and never switched to
+  the quick UID listing. Each budgeted run now leaves out the mail already done and located and lists the next
+  part; once the rest is listed whole, the folder is located. Such a run checks no deletions.
 
 ## 0.490.0 — 31.10.2026
 

package/dist/mail/sync.js

@@ -147,6 +147,8 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
     /** Every folder's stored point, valid or not: the widest window outlives what invalidates the rest. */
     const storedPoints = new Map();
     const resumed = new Set();
+    /** Backfilling folders listed without the mail already done and located: their listing proves no deletion. */
+    const narrowed = new Set();
     let mboxPoint;
     let mboxStamp;
     // A rerun lists only what the last left; --rescan, a rule change or a new UIDVALIDITY lists everything again.
@@ -254,6 +256,15 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
                     resumed.add(folder);
                     wanted = { ...searched, uids: searched.uids.filter((uid) => !within(point.done, Number(uid))) };
                 }
+                else if (backfill && plan !== undefined) {
+                    // A budgeted run lists newest first, so a backfill that starts over every run never reaches the oldest mail.
+                    const placed = new Set((await store.mail.folderEmails(accountId, folder, searched.validity)).map(({ uid }) => uid));
+                    const left = searched.uids.filter((uid) => !(placed.has(Number(uid)) && within(point.done, Number(uid))));
+                    if (left.length < searched.uids.length) {
+                        narrowed.add(folder);
+                        wanted = { ...searched, uids: left };
+                    }
+                }
             }
             if (plan !== undefined) {
                 plan.modes.set(folder, resumed.has(folder) ? "resumed" : "full");
@@ -364,6 +375,8 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
                     ? "folders this run did not list by UID are not checked for deletions; --rescan lists every message and checks them"
                     : undefined);
     }
+    else if (narrowed.size > 0)
+        skipped = "this run listed only mail whose place is not stored yet; once every place is, deletions are checked";
     else if (resumed.size > 0)
         skipped =
             "this run listed only mail not read before; a full listing, at least daily or with --rescan, checks deletions";
@@ -487,6 +500,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
             // A narrower whole listing, like the timer's 30 days, does not replace a wider one that is still fresh.
             const keepFull = before !== undefined &&
                 (resumed.has(folder) ||
+                    narrowed.has(folder) ||
                     (Date.parse(before.full.since) < since.getTime() && startedAt - Date.parse(before.full.at) < FULL_PASS_MS));
             const merged = mergeRanges(before?.done ?? [], rangesOf(done));
             const widest = before === undefined || since.getTime() <= Date.parse(before.window.since);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.490.0",
+  "version": "0.491.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",