@wirecat/cli-core 0.525.0 → 0.526.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ shape of this file.
 
 ## Unreleased
 
+## 0.526.0 — 01.11.2026
+
+### Added
+
+- **`mailIds` from `@wirecat/cli-core/mail`: one email id for mail and memo.** On every server but Gmail the id is
+  the hash of the Message-ID (the UID with its folder and UIDVALIDITY when there is none) and the thread is the first
+  id of References, else In-Reply-To. OBJECTID's EMAILID is not used, so a server that turns OBJECTID on keeps its
+  ids. Gmail keeps X-GM-MSGID and X-GM-THRID.
+- **`decodedLabelName` for a Gmail label already decoded.** imapflow decodes X-GM-LABELS; `labelName` decodes the
+  modified UTF-7 again and turned `R&D-team` into `Rteam`. `labelName` stays for the wire form.
+- **`storedMailRuleSet`: the stored rules this build cannot read, with why.** A sync reports them instead of dropping
+  them silently; `storedMailRules` still returns only the rules.
+
+### Fixed
+
+- **`conversations list` and `conversations show` no longer read a failing store as "nothing stored".** Only a
+  missing account answers empty or not found; a locked or broken store fails the command.
+- **The messenger `search messages` help sends mail searches to `mail <profile> search messages`**, not to memo.
+
 ## 0.525.0 — 01.11.2026
 
 ### Added

package/dist/cli/messenger/messages-search-command.js

@@ -49,7 +49,7 @@ offer \`${messenger.app.command} messages sync <chat>\` and run it only once the
         : `Search reads the local archive: what \`${messenger.app.command} serve\` has kept since the account was linked.
 Keep serve running so new messages are searchable.`} Notes are
 \`${messenger.app.command} search notes\`, messages and notes at once \`${messenger.app.command} search all\`; for mail,
-the separate memo CLI: \`memo search mail\`.
+the mail CLI: \`mail <profile> search messages\`.
 A bare word looks in message text, voice transcripts, file names and file text. text:, transcript:,
 content: (the text of files) and filename: (their names) narrow it to one —
 \`${messenger.app.command} search messages 'content:invoice'\`. chat: narrows it to one chat; has:voice, has:file and

package/dist/mail/cli/index.js

@@ -18,6 +18,12 @@ import { searchMailServer } from "../../mail/server-search.js";
 import { atDetail } from "../../output-detail.js";
 import { sourceKey } from "../../services/server-search.js";
 import { queryFilter, THREAD_COLUMNS } from "../../store/store.js";
+/** A locked or broken store must fail the command, not read as "nothing stored yet". */
+const absentAccount = (error) => {
+    if (error instanceof CliError && error.code === "not_found")
+        return undefined;
+    throw error;
+};
 const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 100;
 const limitOf = (value) => {
@@ -252,7 +258,7 @@ const conversationsCommand = (mail) => {
         const typed = typedQuery(words);
         const query = listQuery(typed, THREAD_QUERY, "conversations list");
         const { threads, mailbox } = await mail.read(this, async (store, mailbox) => {
-            const account = await store.accounts.storedAccount(mailbox).catch(() => undefined);
+            const account = await store.accounts.storedAccount(mailbox).catch(absentAccount);
             if (!account)
                 return { threads: [], mailbox };
             const where = query ? queryFilter(query, THREAD_COLUMNS, { command: "conversations list" }) : undefined;
@@ -296,7 +302,7 @@ const conversationsCommand = (mail) => {
         const full = detailOf(this) === "full";
         const emails = await mail.read(this, async (store, mailbox) => {
             const thread = threadOf(mailbox, given);
-            const account = await store.accounts.storedAccount(mailbox).catch(() => undefined);
+            const account = await store.accounts.storedAccount(mailbox).catch(absentAccount);
             const hits = account ? await store.mail.threadHits(account.id, thread) : [];
             if (!account || hits.length === 0)
                 throw new CliError("not_found", `no stored thread ${given}`);

package/dist/mail/ids.d.ts

@@ -0,0 +1,20 @@
+export interface MailIdsInput {
+    /** As the server's envelope gives it; read from `head` when absent. */
+    messageId?: string | undefined;
+    /** Header text holding at least References and In-Reply-To. */
+    head: string;
+    folder: string;
+    validity: string;
+    uid: string;
+}
+/**
+ * The ids of an email on any server but Gmail, whose X-GM-MSGID and X-GM-THRID are used as they are. OBJECTID's
+ * EMAILID is not used: mail and memo must give one email one id, and a server that turns OBJECTID on later must not
+ * store its mail again. The Message-ID is the identity; without one, the UID, which means nothing without
+ * UIDVALIDITY. The thread is the first Message-ID of References, the thread's first email (RFC 5322 §3.6.4), else
+ * In-Reply-To's parent, so a server without thread ids (Yandex, Mail.ru) still keeps a conversation together.
+ */
+export declare const mailIds: ({ messageId, head, folder, validity, uid }: MailIdsInput) => {
+    messageId: string;
+    threadId: string;
+};

package/dist/mail/ids.js

@@ -0,0 +1,17 @@
+import { createHash } from "node:crypto";
+import { field, unfold } from "./headers.js";
+const digest = (id) => `imap:${createHash("sha256").update(id).digest("hex")}`;
+const firstId = (value) => /<[^<>\s]+>/.exec(value ?? "")?.[0];
+/**
+ * The ids of an email on any server but Gmail, whose X-GM-MSGID and X-GM-THRID are used as they are. OBJECTID's
+ * EMAILID is not used: mail and memo must give one email one id, and a server that turns OBJECTID on later must not
+ * store its mail again. The Message-ID is the identity; without one, the UID, which means nothing without
+ * UIDVALIDITY. The thread is the first Message-ID of References, the thread's first email (RFC 5322 §3.6.4), else
+ * In-Reply-To's parent, so a server without thread ids (Yandex, Mail.ru) still keeps a conversation together.
+ */
+export const mailIds = ({ messageId, head, folder, validity, uid }) => {
+    const unfolded = unfold(head);
+    const identity = (messageId ?? field(unfolded, "message-id"))?.trim() || `uid:${folder}:${validity}:${uid}`;
+    const root = firstId(field(unfolded, "references")) ?? firstId(field(unfolded, "in-reply-to"));
+    return { messageId: digest(identity), threadId: digest(root ?? identity) };
+};

package/dist/mail/index.d.ts

@@ -3,7 +3,8 @@ export { factsOf } from "./facts.js";
 export { GMAIL_ALL_MAIL, mailFolders } from "./folders.js";
 export { dropMissing, type Gone, tooManyGone } from "./gone.js";
 export { type AuthVerdicts, HEADER_FIELDS, headersOf, type MailHeaders, mailHeadersOf } from "./headers.js";
-export { decodeMailboxName, labelName, systemLabel } from "./labels.js";
+export { type MailIdsInput, mailIds } from "./ids.js";
+export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
 export { type Address, htmlToText, looksLikeHtml, MAX_BODY_CHARS, type ParsedMail, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, type PresetName, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, type Probe, type ProbeGroup, probeMail, SUGGEST_RULE } from "./probe.js";
@@ -11,7 +12,7 @@ export { type MailFolderProgress, mailProgress } from "./progress.js";
 export { ATTACHMENT_CHARS, attachmentsText, hitText, lowerSuspicious, type MailSearch, type ShownMail, searchMail, showMail, withAttachmentText, } from "./read.js";
 export { type FileStamp, FULL_PASS_MS, MBOX_RESUME, type MboxPoint, mergeRanges, parsePoint, type Ranges, type ResumePoint, rangesOf, resumeKey, rulesKey, within, } from "./resume.js";
 export { ruleInput, STORE_ACTION } from "./rule-input.js";
-export { storedMailRule, storedMailRules } from "./rule-stored.js";
+export { type MailRuleSet, storedMailRule, storedMailRuleSet, storedMailRules } from "./rule-stored.js";
 export { mapProposedTags, ruleTagger, settleRuleTags, type TagOutcome } from "./rule-tags.js";
 export { conditionKeys, decide, describeMatch, ENVELOPE, envelopeBox, envelopeBoxOf, type MailAction, type MailFacts, type MailRule, type MailRuleMatch, matches, sameMatch, tagsOf, } from "./rules.js";
 export { type DomainAge, FRAUD_SIGNALS, FREE_MAIL, registrableOf, SCORE_RULE, type Scored, type Signal, scoreGroup, WEIGHTS, } from "./score.js";

package/dist/mail/index.js

@@ -3,7 +3,8 @@ export { factsOf } from "./facts.js";
 export { GMAIL_ALL_MAIL, mailFolders } from "./folders.js";
 export { dropMissing, tooManyGone } from "./gone.js";
 export { HEADER_FIELDS, headersOf, mailHeadersOf } from "./headers.js";
-export { decodeMailboxName, labelName, systemLabel } from "./labels.js";
+export { mailIds } from "./ids.js";
+export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
 export { htmlToText, looksLikeHtml, MAX_BODY_CHARS, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, probeMail, SUGGEST_RULE } from "./probe.js";
@@ -11,7 +12,7 @@ export { mailProgress } from "./progress.js";
 export { ATTACHMENT_CHARS, attachmentsText, hitText, lowerSuspicious, searchMail, showMail, withAttachmentText, } from "./read.js";
 export { FULL_PASS_MS, MBOX_RESUME, mergeRanges, parsePoint, rangesOf, resumeKey, rulesKey, within, } from "./resume.js";
 export { ruleInput, STORE_ACTION } from "./rule-input.js";
-export { storedMailRule, storedMailRules } from "./rule-stored.js";
+export { storedMailRule, storedMailRuleSet, storedMailRules } from "./rule-stored.js";
 export { mapProposedTags, ruleTagger, settleRuleTags } from "./rule-tags.js";
 export { conditionKeys, decide, describeMatch, ENVELOPE, envelopeBox, envelopeBoxOf, matches, sameMatch, tagsOf, } from "./rules.js";
 export { FRAUD_SIGNALS, FREE_MAIL, registrableOf, SCORE_RULE, scoreGroup, WEIGHTS, } from "./score.js";

package/dist/mail/labels.d.ts

@@ -1,5 +1,10 @@
 /** IMAP's modified UTF-7 (RFC 3501 §5.1.3): `&` opens base64 of UTF-16BE, `,` stands for `/`, `-` closes. */
 export declare const decodeMailboxName: (name: string) => string;
 export declare const systemLabel: (name: string) => string;
-/** A label as people read it: `\\Important` and `Important` are one label, and names are decoded. */
+/**
+ * A label as people read it, from a name already decoded (imapflow decodes X-GM-LABELS): `\\Important` and
+ * `Important` are one label. Decoding twice would turn `R&D-team` into `Rteam`.
+ */
+export declare const decodedLabelName: (name: string) => string;
+/** The same from X-GM-LABELS as the server sends it, in modified UTF-7. */
 export declare const labelName: (raw: string) => string;

package/dist/mail/labels.js

@@ -20,8 +20,13 @@ export const decodeMailboxName = (name) => name.replace(/&([^-]*)-/g, (_, run) =
     return text;
 });
 export const systemLabel = (name) => SYSTEM_LABELS[name.toLowerCase()] ?? name;
-/** A label as people read it: `\\Important` and `Important` are one label, and names are decoded. */
-export const labelName = (raw) => {
-    const system = raw.startsWith("\\") ? raw.slice(1) : raw;
-    return SYSTEM_LABELS[system.toLowerCase()] ?? decodeMailboxName(system);
+/**
+ * A label as people read it, from a name already decoded (imapflow decodes X-GM-LABELS): `\\Important` and
+ * `Important` are one label. Decoding twice would turn `R&D-team` into `Rteam`.
+ */
+export const decodedLabelName = (name) => {
+    const system = name.startsWith("\\") ? name.slice(1) : name;
+    return SYSTEM_LABELS[system.toLowerCase()] ?? system;
 };
+/** The same from X-GM-LABELS as the server sends it, in modified UTF-7. */
+export const labelName = (raw) => decodedLabelName(decodeMailboxName(raw));

package/dist/mail/rule-stored.d.ts

@@ -3,7 +3,21 @@ import type { MessageStore, MailRule as StoredRule } from "../store/index.js";
 import type { MailRule } from "./rules.js";
 /** A stored rule as the sync reads it; `undefined` for one this build cannot read, so it is left to the build that can. */
 export declare const storedMailRule: (stored: StoredRule) => MailRule | undefined;
+export interface MailRuleSet {
+    rules: MailRule[];
+    /**
+     * Stored rules this build cannot read, each with what it does not know. The sync leaves them out, and a build that
+     * reads them decides mail differently, so a sync reports them rather than drop them silently.
+     */
+    unreadable: {
+        id: number;
+        why: string;
+    }[];
+}
 /** One account's rules from the store, for `account.rules` of the sync; none when the store has not seen the account. */
+export declare const storedMailRuleSet: (store: MessageStore, account: {
+    address: string;
+}, query?: QueryAst) => Promise<MailRuleSet>;
 export declare const storedMailRules: (store: MessageStore, account: {
     address: string;
 }, query?: QueryAst) => Promise<MailRule[]>;

package/dist/mail/rule-stored.js

@@ -17,15 +17,24 @@ const KINDS = {
     score_at_least: "number",
     preset: "string",
 };
+/** Why this build cannot read a stored rule, or undefined when it can. */
+const unreadable = (stored) => {
+    if (ACTION_OF[String(stored.actions.store)] === undefined)
+        return `action ${String(stored.actions.store)}`;
+    const entries = Object.entries(stored.conditions);
+    if (entries.length === 0)
+        return "no condition";
+    const unknown = entries.find(([key, value]) => !(key in KINDS) ||
+        typeof value !== KINDS[key] ||
+        (key === "preset" && !PRESET_NAMES.includes(value)));
+    return unknown && `condition ${unknown[0]}`;
+};
 /** A stored rule as the sync reads it; `undefined` for one this build cannot read, so it is left to the build that can. */
 export const storedMailRule = (stored) => {
+    if (unreadable(stored) !== undefined)
+        return undefined;
     const action = ACTION_OF[String(stored.actions.store)];
     const entries = Object.entries(stored.conditions);
-    const known = entries.every(([key, value]) => key in KINDS &&
-        typeof value === KINDS[key] &&
-        !(key === "preset" && !PRESET_NAMES.includes(value)));
-    if (action === undefined || !known || entries.length === 0)
-        return undefined;
     const tags = Array.isArray(stored.actions.tags) ? stored.actions.tags.filter((tag) => typeof tag === "string") : [];
     const skipped = stored.actions.tags_skipped;
     const tagsSkipped = skipped !== null && typeof skipped === "object" && !Array.isArray(skipped)
@@ -44,14 +53,25 @@ export const storedMailRule = (stored) => {
     };
 };
 /** One account's rules from the store, for `account.rules` of the sync; none when the store has not seen the account. */
-export const storedMailRules = async (store, account, query) => {
+export const storedMailRuleSet = async (store, account, query) => {
+    let stored;
     try {
         const { id } = await store.accounts.storedAccount({ provider: "email", account: account.address.toLowerCase() });
-        return (await store.mail.rules.list(id, query)).flatMap((stored) => storedMailRule(stored) ?? []);
+        stored = await store.mail.rules.list(id, query);
     }
     catch (error) {
         if (error instanceof CliError && error.code === "not_found")
-            return [];
+            return { rules: [], unreadable: [] };
         throw error;
     }
+    const set = { rules: [], unreadable: [] };
+    for (const one of stored) {
+        const why = unreadable(one);
+        if (why === undefined)
+            set.rules.push(storedMailRule(one));
+        else
+            set.unreadable.push({ id: one.id, why });
+    }
+    return set;
 };
+export const storedMailRules = async (store, account, query) => (await storedMailRuleSet(store, account, query)).rules;

package/package.json

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