@wirecat/cli-core 0.553.0 → 0.554.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ shape of this file.
 
 ## Unreleased
 
+## 0.554.0 — 02.11.2026
+
+### Fixed
+
+- **`schedule agent` help no longer shows `skill show follow-ups` to a CLI without that skill.** The prompt example is
+  the follow-up review for a messenger and a read-only `search messages` summary for a CLI with `messenger: false`
+  (mail).
+- **Mail sync stores `sent_at`.** It is the Date header, or the server's internal date when the header is missing or
+  unreadable; `received_at` is unchanged. Each sync also gives up to 5,000 emails stored without `sent_at` the internal
+  date (`MailStore.backfillSentAt`), so the `emails_by_time` index becomes useful and an account fills in about a day.
+  No schema change.
+
 ## 0.553.0 — 02.11.2026
 
 ### Added

package/dist/cli/schedule/schedule-command.d.ts

@@ -1,7 +1,6 @@
 import { Command } from "commander";
 import { type AppIdentity } from "../../ports/app.js";
 import { type AnswerOutput } from "../envelope.js";
-/** What the schedule command needs of a CLI: who it is and, per command, where it prints and which profile runs. */
 export interface ScheduleHost {
     app: AppIdentity;
     context(command: Command, resolving?: {

package/dist/cli/schedule/schedule-command.js

@@ -68,6 +68,11 @@ const withWhen = (command) => command
     .option("--every <duration>", "repeat: 30m, 2h, 1d")
     .option("--at <HH:MM>", "every day at this local time")
     .option("--at-time <time>", "one run: 30m, 2d from now, or an ISO time; the schedule removes itself after it");
+/** What the schedule command needs of a CLI: who it is and, per command, where it prints and which profile runs. */
+/** `skill show follow-ups` exists only for messenger CLIs; any other CLI gets a read-only summary it can run. */
+const promptExample = (app) => app.messenger === false
+    ? `summarize what came in during the last day: ${app.command} personal search messages 'date>1d' --newest --limit 20`
+    : `run the daily follow-up review: ${app.command} skill show follow-ups`;
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
  * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
@@ -142,7 +147,7 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         .description(`start an agent (claude or codex) with a prompt on a timer; it runs with ${app.envPrefix}_READ_ONLY=1, so it reads and drafts and cannot send — its answer is kept and you are notified`)
         .argument("<name>", "lowercase letters, digits and dashes")
         .addArgument(new Argument("<harness>", "the agent to start").choices(HARNESSES))
-        .argument("<prompt>", `what to do, e.g. "run the daily follow-up review: ${app.command} skill show follow-ups"`)
+        .argument("<prompt>", `what to do, e.g. "${promptExample(app)}"`)
         .addOption(new Option("--max-cost <usd>", "claude only: stop a run that costs more than this, in US dollars").argParser(Number))).action(async function (name, harness, prompt) {
         const { context, system, environment, save } = prepare(this);
         const options = this.opts();

package/dist/mail/email-input.d.ts

@@ -1,5 +1,7 @@
 import type { EmailInput } from "../store/index.js";
 import type { ParsedMail } from "./parse.js";
 import type { Listed } from "./source.js";
+/** The Date header, or the server's internal date when the header is missing or unreadable. */
+export declare const sentAtOf: (date: string | null, receivedAt: string) => number;
 /** What one read email stores of itself, whichever run read it; where it is filed is the caller's. */
 export declare const parsedEmail: (mail: ParsedMail, item: Listed, header: Record<string, string | boolean>, address: string) => Omit<EmailInput, "mailboxes">;

package/dist/mail/email-input.js

@@ -1,4 +1,9 @@
 import { addressOf } from "./attachments.js";
+/** The Date header, or the server's internal date when the header is missing or unreadable. */
+export const sentAtOf = (date, receivedAt) => {
+    const sent = date === null ? Number.NaN : Date.parse(date);
+    return Number.isNaN(sent) ? Date.parse(receivedAt) : sent;
+};
 /** What one read email stores of itself, whichever run read it; where it is filed is the caller's. */
 export const parsedEmail = (mail, item, header, address) => ({
     externalId: item.messageId,
@@ -7,7 +12,7 @@ export const parsedEmail = (mail, item, header, address) => ({
     to: mail.to.map(addressOf),
     cc: mail.cc.map(addressOf),
     bcc: mail.bcc.map(addressOf),
-    sentAt: null,
+    sentAt: sentAtOf(mail.date, item.receivedAt),
     receivedAt: Date.parse(item.receivedAt),
     bodyText: mail.text || null,
     size: item.size ?? null,

package/dist/mail/retry.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { mailAccountKey } from "./account-key.js";
 import { addressOf, FETCH_CHUNK, readAttachments } from "./attachments.js";
+import { sentAtOf } from "./email-input.js";
 import { mailFolders } from "./folders.js";
 import { mailHeadersOf } from "./headers.js";
 import { parseMail } from "./parse.js";
@@ -74,7 +75,7 @@ export const retryUnread = async ({ store, source, account, since, max, maxBodyC
                         to: mail.to.map(addressOf),
                         cc: mail.cc.map(addressOf),
                         bcc: mail.bcc.map(addressOf),
-                        sentAt: null,
+                        sentAt: sentAtOf(mail.date, item.receivedAt),
                         receivedAt: Date.parse(item.receivedAt),
                         bodyText: mail.text || null,
                         size: item.size ?? stored.size,

package/dist/mail/sync.js

@@ -24,6 +24,8 @@ const DAY = 86_400_000;
 const EDGE = 2 * DAY;
 /** How often a long run saves where it is, so a kill costs at most this much listing again. */
 const SAVE_EVERY_MS = 30_000;
+/** About 55 runs clear a 276,000-email account; each is a short write that does not hold the sync up. */
+const SENT_AT_BACKFILL_PER_RUN = 5000;
 const SLICE_SIZE = 50;
 const SLICE_PAUSE_MS = 100;
 /** About a minute of listing; the 30-day window of the timer stays below it. */
@@ -682,7 +684,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
                     // Subject and text stay out of the columns search reads, so recorded mail is never a search hit.
                     subject: null,
                     from: headers?.from === undefined ? null : { address: headers.from, name: headers.fromName ?? null },
-                    sentAt: null,
+                    sentAt: Date.parse(item.receivedAt),
                     receivedAt: Date.parse(item.receivedAt),
                     bodyText: null,
                     size: item.size ?? null,
@@ -816,6 +818,8 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
         await store.mail.setMailboxes(accountId, [bulkBox], bulk, startedAt);
     if (!snapshot)
         await store.sync.setSyncState(key, "mail_folder_scope", scope);
+    if (!snapshot)
+        await store.mail.backfillSentAt(accountId, SENT_AT_BACKFILL_PER_RUN);
     await stopIfAborted();
     const indexed = await index?.(store, key);
     const coverage = {

package/dist/mail/testing/fake.d.ts

@@ -12,6 +12,8 @@ export interface FakeMail {
     from: FakePerson;
     to: FakePerson[];
     cc?: FakePerson[];
+    /** The Date header, when it differs from the server's internal date `receivedAt`. */
+    date?: string;
     text?: string;
     html?: string;
     listId?: string;

package/dist/mail/testing/fake.js

@@ -31,7 +31,7 @@ export const rawOf = (m) => {
         ...(m.listId ? [`List-Id: News <${m.listId}>`, `List-Unsubscribe: <mailto:leave@${m.listId}>`] : []),
         `Subject: ${m.subject}`,
         `Message-ID: <${m.messageId}@example.test>`,
-        `Date: ${new Date(m.receivedAt).toUTCString()}`,
+        `Date: ${m.date ?? new Date(m.receivedAt).toUTCString()}`,
         "MIME-Version: 1.0",
         ...(m.extraHeaders ?? []),
     ];

package/dist/store/sqlite/email-locations.d.ts

@@ -59,3 +59,4 @@ export declare const partialMail: (database: CacheDatabase) => PartialMailStore;
 export declare const storedWhole: (database: CacheDatabase, emailId: number) => boolean;
 export declare const setLocations: (database: CacheDatabase, accountId: number, folder: string, uidvalidity: string, found: ReadonlyMap<string, number[]>) => number;
 export declare const forgetLocations: (database: CacheDatabase, accountId: number, folder: string, uidvalidity: string, uids: number[]) => void;
+export declare const backfillSentAt: (database: CacheDatabase, accountId: number, limit: number) => number;

package/dist/store/sqlite/email-locations.js

@@ -107,3 +107,7 @@ export const forgetLocations = (database, accountId, folder, uidvalidity, uids)
     for (const emailId of new Set(emails))
         leave.run(emailId, Number(box.id), emailId, Number(box.id));
 };
+export const backfillSentAt = (database, accountId, limit) => Number(database
+    .prepare(`UPDATE emails SET sent_at = received_at WHERE id IN (
+           SELECT id FROM emails WHERE account_id = ? AND sent_at IS NULL AND received_at IS NOT NULL LIMIT ?)`)
+    .run(accountId, limit).changes);

package/dist/store/sqlite/emails.d.ts

@@ -238,6 +238,8 @@ export interface MailStore extends PartialMailStore {
         read?: boolean;
         flagged?: boolean;
     }>, now: number): Promise<number>;
+    /** Gives up to `limit` emails stored without `sent_at` their internal date; answers how many. */
+    backfillSentAt(accountId: number, limit: number): Promise<number>;
     /** The live emails whose location in `folder` has this UIDVALIDITY, oldest UID first. */
     folderEmails(accountId: number, folder: string, uidvalidity: string): Promise<FolderEmail[]>;
     /**

package/dist/store/sqlite/emails.js

@@ -2,7 +2,7 @@ import { formatLocator } from "../../domain/locator.js";
 import { formatReference } from "../../domain/references.js";
 import { fold, normalize } from "../normalize.js";
 import { chunkAttachments, drainEmailIndex, dropAttachmentChunks, MAIL_PIECES, queueThreads, threadPieces, titleOf, } from "./email-index.js";
-import { folderEmails, forgetLocations, locate, partialMail, setLocations, storedWhole, } from "./email-locations.js";
+import { backfillSentAt, folderEmails, forgetLocations, locate, partialMail, setLocations, storedWhole, } from "./email-locations.js";
 import { markEmailsDeleted, markEmailsRestored, recountEmailThread as recount, setEmailFlags } from "./email-state.js";
 import { bool, flag, fromJson, int, page, str, toJson } from "./events.js";
 import { folded } from "./folded.js";
@@ -554,11 +554,8 @@ export const mailStoreOver = ({ database, orm, now }, stemmerFor = stemmerCache(
             return count;
         });
     },
-    async setFlags(accountId, flags, now) {
-        return write(database, () => {
-            return setEmailFlags(database, accountId, flags, now);
-        });
-    },
+    setFlags: async (accountId, flags, now) => write(database, () => setEmailFlags(database, accountId, flags, now)),
+    backfillSentAt: async (accountId, limit) => write(database, () => backfillSentAt(database, accountId, limit)),
     folderEmails: async (accountId, folder, uidvalidity) => folderEmails(database, accountId, folder, uidvalidity),
     setLocations: async (accountId, folder, uidvalidity, found) => write(database, () => setLocations(database, accountId, folder, uidvalidity, found)),
     forgetLocations: async (accountId, folder, uidvalidity, uids) => write(database, () => forgetLocations(database, accountId, folder, uidvalidity, uids)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.553.0",
+  "version": "0.554.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",