@wirecat/cli-core 0.349.0 → 0.351.0

package/CHANGELOG.md

@@ -7,6 +7,37 @@ shape of this file.
 
 ## Unreleased
 
+## 0.351.0 — 19.10.2026
+
+### Added
+
+- **`findEvidenceMentions(vocabulary, result, { exclude })`** names the existing projects, tags and topics whose
+  name, key or alias appears in a `gatherProjectEvidence` result's excerpts and their neighbours, each match cited
+  and marked when the term belongs to more than one entry; a vocabulary over its budget is skipped, not fatal. The
+  project matcher behind `createMeetingProjectCandidateReader` is the same code (`matchVocabularyTerms`).
+- **`storedNeighbours(store)`**: the neighbours port for chat messages and mail; a mail hit carries the emails
+  before and after it in its thread. `storedMessageNeighbours` returns nothing for a mail reference.
+
+## 0.350.0 — 19.10.2026
+
+### Added
+
+- **A messenger that pushes its history can be told the chats the store holds**: the optional
+  `PushedHistory.storedChats(ids)` gets every chat id of this account once as `feed` starts, in `serve` and `watch`.
+  whatsapp-cli uses it to re-key phone-form chats nothing names again, through `rekeys`. A reject is a
+  `stored_chats_failed` warning. The contract kit has a case for it, skipped without the method, and
+  `fakeAdapter(seed, { storedChats: true })`.
+- **`loginQr().show(link, scan)` says where to scan only once a code exists**: after the drawn code, or after
+  the `--qr-file` note. On a terminal too narrow to draw the code, only the hint to widen it or pass `--qr-file`
+  is shown. Before, the CLIs said "scan this code" first, so a narrow terminal asked to scan a code that was
+  never drawn. `scan` is optional and nothing changes without it: an adapter drops its own scan note before
+  `show()` and passes that text as `show(link, scan)` instead.
+
+### Fixed
+
+- **A `storedChats` hook that never finishes no longer says messages were not saved** at exit: after the 5 s wait
+  it is a `stored_chats_failed` warning that the hook was abandoned, since it only reads chat ids.
+
 ## 0.349.0 — 19.10.2026
 
 ### Added

package/dist/cli/messenger/context.js

@@ -193,6 +193,7 @@ export const connected = (connection, { app, provider, name, deletedWithoutChat,
     const pacer = new Pacer(pacePathFor(app, settings.profile, env), rate);
     const adapter = observed(flooded(connection, memory, { name: name ?? app.command, warn: renderer.warn, pacer }), events);
     const pending = new Set();
+    const announcing = new Set();
     const saving = self === null
         ? adapter
         : stored(adapter, {
@@ -202,6 +203,7 @@ export const connected = (connection, { app, provider, name, deletedWithoutChat,
             warn: renderer.warn,
             events,
             pending,
+            announcing,
             ...(deletedWithoutChat ? { deletedWithoutChat } : {}),
             rekeyed: (from, to) => rekeyRecipients(app, settings.profile, env, renderer.warn, from, to),
             ...(history === "store" ? { namesFromStore: savedChatId ? { savedChatId } : {} } : {}),
@@ -226,10 +228,15 @@ export const connected = (connection, { app, provider, name, deletedWithoutChat,
                         events({ event: "warning", code: "store_not_written", operation });
                         renderer.warn(`not saved to the local store: the messenger was still handing on ${what} at exit`);
                     });
-                    if (!(await settled(pending, SAVES_WAIT_MS))) {
+                    await settled(new Set([...pending, ...announcing]), SAVES_WAIT_MS);
+                    if (pending.size > 0) {
                         events({ event: "warning", code: "store_not_written", operation: "close" });
                         renderer.warn("not saved to the local store: the last messages were still being written at exit");
                     }
+                    if (announcing.size > 0) {
+                        events({ event: "warning", code: "stored_chats_failed", operation: "close" });
+                        renderer.warn("the messenger's stored-chats hook did not finish and was abandoned at exit; nothing is lost");
+                    }
                 }
                 finally {
                     await store.close();

package/dist/cli/messenger/flooded.js

@@ -3,7 +3,7 @@ import { isCliFailure } from "../../errors/failures.js";
 import { throughWrapper } from "../../ports/messenger.js";
 import { providerErrorKey } from "../../runs/events.js";
 import { holdEnd } from "../../sends/flood.js";
-const LONG_LIVED = new Set(["self", "newSendId", "close", "formatMarkdown", "formatHtml"]);
+const LONG_LIVED = new Set(["self", "newSendId", "close", "formatMarkdown", "formatHtml", "storedChats"]);
 /** Neither held nor paced, as they listen for as long as the run does; what ends them is still remembered. */
 const LISTENING = new Set(["watch", "feed", "listen", "listenHistory"]);
 const BLOCKING = new Set(["frozen", "limited", "banned"]);

package/dist/cli/messenger/serve-relay.js

@@ -10,6 +10,7 @@ import { environmentOf } from "../context.js";
 export const lentConnection = (connection, watchers) => throughWrapper(connection, {
     close: async () => { },
     feed: undefined,
+    storedChats: undefined,
     listen: undefined,
     listenHistory: undefined,
     ...(connection.watch && watchers

package/dist/cli/messenger/stored.d.ts

@@ -11,6 +11,8 @@ export interface Saving {
     events: EventSink;
     /** Saves still writing, for the closer to wait on: `watch` does not hold the next event for one. */
     pending?: Set<Promise<void>>;
+    /** `storedChats` calls still running, apart from `pending`: one abandoned at exit leaves nothing unsaved. */
+    announcing?: Set<Promise<void>>;
     deletedWithoutChat?: DeletionScope;
     /** The app command and profile running, recorded with the first save so another app can name this account. */
     profile?: {
@@ -33,4 +35,4 @@ export interface Saving {
  * would erase what `chats list` stored. Nor are `chat` and `contact`: a card's member list is not
  * known to be whole, and `saveMembers` replaces the list.
  */
-export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, deletedWithoutChat, profile, rekeyed, namesFromStore }: Saving) => MessengerAdapter;
+export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, namesFromStore }: Saving) => MessengerAdapter;

package/dist/cli/messenger/stored.js

@@ -11,7 +11,7 @@ import { chatIdIn } from "../../services/message-resolution.js";
  * would erase what `chats list` stored. Nor are `chat` and `contact`: a card's member list is not
  * known to be whole, and `saveMembers` replaces the list.
  */
-export const stored = (messenger, { account, store, warn, events, pending, deletedWithoutChat, profile, rekeyed, namesFromStore }) => {
+export const stored = (messenger, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, namesFromStore }) => {
     let warned = false;
     let recorded = profile === undefined;
     const attempt = async (operation, write) => {
@@ -243,7 +243,14 @@ export const stored = (messenger, { account, store, warn, events, pending, delet
             : {}),
         ...(messenger.feed
             ? {
-                feed: (onBatch, signal) => messenger.feed?.(saveBatches("history.feed", onBatch), signal) ?? Promise.resolve(),
+                feed: (onBatch, signal) => {
+                    if (messenger.storedChats) {
+                        const announced = announceStoredChats(messenger, store, account, events, warn);
+                        announcing?.add(announced);
+                        void announced.finally(() => announcing?.delete(announced));
+                    }
+                    return messenger.feed?.(saveBatches("history.feed", onBatch), signal) ?? Promise.resolve();
+                },
             }
             : {}),
         ...(messenger.listenHistory
@@ -348,6 +355,19 @@ const personIn = (people, reference) => {
         throw error;
     }
 };
+const announceStoredChats = async (messenger, store, account, events, warn) => {
+    try {
+        const opened = await store();
+        if (!opened)
+            return;
+        const ids = (await opened.forAccount(account).chats.chats({})).items.map((chat) => chat.id);
+        await messenger.storedChats?.(ids);
+    }
+    catch (error) {
+        events({ event: "warning", code: "stored_chats_failed", operation: "history.stored_chats" });
+        warn(`the messenger was not told the stored chats: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
 /** Read once when `watch` starts: a store read per event would let a later event overtake an earlier one. */
 const rememberTitles = async (store, account, titles) => {
     try {

package/dist/kit/contract.d.ts

@@ -22,7 +22,7 @@ export interface ContractOptions {
     history?: "server" | "store";
 }
 /** Every method of the optional groups, which `capability` hands over or refuses. */
-export declare const OPTIONAL_METHODS: readonly ["fetchCounters", "chats", "history", "around", "contact", "historyAfter", "historyBefore", "topics", "inspect", "edit", "forward", "delete", "pin", "unpin", "star", "react", "markRead", "markTopicRead", "poll", "vote", "closePoll", "createPoll", "watch", "listen", "listenHistory", "feed", "download", "transcribe", "scheduled", "members", "admins", "chatEvents", "sessions", "lookup", "addressBook", "people", "createGroup", "join", "leave", "group", "updateGroup", "resetInviteLink", "addMembers", "removeMembers", "addAdmin", "removeAdmin", "folders", "createFolder", "updateFolder", "deleteFolder", "addContact", "removeContact", "block", "unblock", "renameContact", "importContacts", "updateProfile", "endOtherSessions"];
+export declare const OPTIONAL_METHODS: readonly ["fetchCounters", "chats", "history", "around", "contact", "historyAfter", "historyBefore", "topics", "inspect", "edit", "forward", "delete", "pin", "unpin", "star", "react", "markRead", "markTopicRead", "poll", "vote", "closePoll", "createPoll", "watch", "listen", "listenHistory", "feed", "storedChats", "download", "transcribe", "scheduled", "members", "admins", "chatEvents", "sessions", "lookup", "addressBook", "people", "createGroup", "join", "leave", "group", "updateGroup", "resetInviteLink", "addMembers", "removeMembers", "addAdmin", "removeAdmin", "folders", "createFolder", "updateFolder", "deleteFolder", "addContact", "removeContact", "block", "unblock", "renameContact", "importContacts", "updateProfile", "endOtherSessions"];
 /**
  * The port's promises as cases any test runner can run: each connects through `connect`, checks
  * with `node:assert/strict` and closes the adapter. None needs a live service.

package/dist/kit/contract.js

@@ -31,6 +31,7 @@ export const OPTIONAL_METHODS = [
     "listen",
     "listenHistory",
     "feed",
+    "storedChats",
     "download",
     "transcribe",
     "scheduled",
@@ -486,6 +487,17 @@ export const contractCases = ({ connect, ids = wordIds, orderBy = "id", waitMs =
                 },
                 "the fake pushes the seed's history once connected, as `fakeAdapter(seed, { feed: true })` does",
             ],
+            [
+                "storedChats takes no ids, and ids it does not know, without rejecting",
+                async (adapter, seed) => {
+                    const skipped = lacking(adapter, "storedChats");
+                    if (skipped)
+                        return skipped;
+                    await within(Promise.resolve(adapter.storedChats?.([])), "storedChats did not resolve for no ids", waitMs);
+                    const ids = [...seed.chats.map((chat) => chat.id), unknownChat];
+                    await within(Promise.resolve(adapter.storedChats?.(ids)), "storedChats did not resolve for the ids", waitMs);
+                },
+            ],
         ]),
         {
             name: "self() is null before a login",

package/dist/kit/fake.d.ts

@@ -6,4 +6,5 @@ export declare const fakeAdapter: (seed?: Seed, options?: {
     feed?: boolean;
     listen?: boolean;
     listenHistory?: boolean;
+    storedChats?: boolean;
 }) => FakeAdapter;

package/dist/kit/fake.js

@@ -29,7 +29,8 @@ const missing = (what) => new CliError("not_found", `the fake adapter has no ${w
  * With `{ feed: true }` it also pushes its history, as a messenger with `history: "store"` does:
  * the chats and people in one batch, then each chat's messages in a batch of their own.
  * With `{ listen: true }` it also has `listen`, which hands on what `watch` does, and with `{ listenHistory: true }`
- * `listenHistory`, which hands on what `feed` does.
+ * `listenHistory`, which hands on what `feed` does. With `{ storedChats: true }` it takes the stored chat ids and
+ * does nothing with them.
  */
 const withRules = (folder, { emoji, include, skip, exclude, pin }) => {
     if (emoji !== undefined)
@@ -337,6 +338,7 @@ export const fakeAdapter = (seed = contractSeed(), options = {}) => {
             : {}),
         ...(options.feed ? { feed: pushHistory } : {}),
         ...(options.listenHistory ? { listenHistory: pushHistory } : {}),
+        ...(options.storedChats ? { storedChats: async () => { } } : {}),
         download: async (reference, messageId) => {
             const message = messageOf(chatOf(reference).id, messageId);
             return {

package/dist/meetings/mcp/index.d.ts

@@ -38,7 +38,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -54,11 +53,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -76,11 +75,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -102,6 +101,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,7 +188,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -204,11 +203,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -226,11 +225,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -252,6 +251,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,7 +338,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -354,11 +353,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -376,11 +375,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -402,6 +401,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,7 +488,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -504,11 +503,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -526,11 +525,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -552,6 +551,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,7 +638,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -654,11 +653,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -676,11 +675,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -702,6 +701,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/ports/messenger.d.ts

@@ -365,6 +365,11 @@ export interface HistoryBatch {
 export interface PushedHistory {
     /** Chats, people and past messages as the messenger pushes them, until `signal` aborts. */
     feed(onBatch: (batch: HistoryBatch) => void, signal: AbortSignal): Promise<void>;
+    /**
+     * Every chat id the store holds for this account, handed over once as `feed` starts, so a chat nothing names again
+     * can still be re-keyed through a later batch's `rekeys`. A reject is a warning; `feed` goes on.
+     */
+    storedChats?(ids: readonly Id[]): void | Promise<void>;
 }
 /** A message's files and its speech, fetched from the messenger. */
 export interface MessageMedia {

package/dist/services/index.d.ts

@@ -5,7 +5,9 @@ export { type DownloadedModel, downloadImageModel, downloadTextModel, type Model
 export type { ProjectEvidenceItem, ProjectGathering, ProjectGatheringPorts, ProjectGatheringStop, ProjectIndexCatchUp, ProjectSourceFetcher, } from "./project-gathering.js";
 export { gatherProjectEvidence } from "./project-gathering.js";
 export type { ProjectNeighbour, ProjectNeighbourReader } from "./project-gathering-around.js";
-export { storedMessageNeighbours } from "./project-gathering-around.js";
+export { storedMessageNeighbours, storedNeighbours } from "./project-gathering-around.js";
+export type { EvidenceMention, EvidenceMentions } from "./project-gathering-mentions.js";
+export { findEvidenceMentions } from "./project-gathering-mentions.js";
 export type { ProjectFetchState, ProjectGatheringBudgets, ProjectGatheringRequest, ProjectLane, ProjectLaneKind, ProjectUnitState, } from "./project-gathering-request.js";
 import { type AccountService } from "./account.js";
 import { type AdminService } from "./admin.js";

package/dist/services/index.js

@@ -2,7 +2,8 @@ import { botCheckService } from "../botcheck/service.js";
 export { createContextEvidenceReader } from "./context-evidence.js";
 export { downloadImageModel, downloadTextModel, } from "./model-downloads.js";
 export { gatherProjectEvidence } from "./project-gathering.js";
-export { storedMessageNeighbours } from "./project-gathering-around.js";
+export { storedMessageNeighbours, storedNeighbours } from "./project-gathering-around.js";
+export { findEvidenceMentions } from "./project-gathering-mentions.js";
 import { accountService } from "./account.js";
 import { adminService } from "./admin.js";
 import { adminStatisticsService } from "./admin-statistics.js";

package/dist/services/meeting-project-candidate-matching.d.ts

@@ -1,5 +1,24 @@
 import type { MeetingProjectCandidateInput } from "../meetings/index.js";
 import type { VocabularyCatalog } from "../store/index.js";
+type Entry = VocabularyCatalog["entries"][number];
+export type VocabularyTerm = {
+    name: string;
+    kind: "canonical" | "key" | "alias";
+    aliasId?: string;
+};
+/** Every entry whose name, key or alias stands as whole words in a text, at most 20 matches an entry. */
+export declare const matchVocabularyTerms: <S>(catalog: VocabularyCatalog, texts: readonly {
+    text: string;
+    source: S;
+}[]) => {
+    entry: Entry;
+    matches: {
+        term: VocabularyTerm;
+        source: S;
+        ambiguous: boolean;
+    }[];
+    omitted: number;
+}[];
 export declare const matchProjectCandidates: (catalog: VocabularyCatalog, input: MeetingProjectCandidateInput) => {
     project: {
         reference: string;
@@ -10,3 +29,4 @@ export declare const matchProjectCandidates: (catalog: VocabularyCatalog, input:
     matches: import("../meetings/project-candidates.js").MeetingProjectCandidateMatch[];
     omittedMatches: number;
 }[];
+export {};

package/dist/services/meeting-project-candidate-matching.js

@@ -5,7 +5,8 @@ const termsOf = (entry) => [
     ...(entry.key ? [{ name: entry.key, kind: "key" }] : []),
     ...entry.aliases.map((alias) => ({ name: alias.name, kind: "alias", aliasId: alias.id })),
 ];
-export const matchProjectCandidates = (catalog, input) => {
+/** Every entry whose name, key or alias stands as whole words in a text, at most 20 matches an entry. */
+export const matchVocabularyTerms = (catalog, texts) => {
     const owners = new Map();
     for (const entry of catalog.entries)
         for (const term of termsOf(entry)) {
@@ -14,29 +15,11 @@ export const matchProjectCandidates = (catalog, input) => {
             ids.add(entry.id);
             owners.set(key, ids);
         }
-    const sources = [
-        ...(input.title === undefined
-            ? []
-            : [
-                {
-                    text: normalizedText(input.title),
-                    source: { kind: "metadata-title", reference: input.reference, fingerprint: null, revision: null },
-                },
-            ]),
-        ...(input.cues ?? []).map((cue) => ({
-            text: normalizedText(cue.text),
-            source: {
-                kind: "transcript",
-                reference: cue.reference,
-                fingerprint: cue.fingerprint,
-                revision: cue.revision,
-            },
-        })),
-    ];
+    const sources = texts.map(({ text, source }) => ({ text: normalizedText(text), source }));
     const result = [];
     for (const entry of catalog.entries) {
         const matches = [];
-        let omittedMatches = 0;
+        let omitted = 0;
         const seen = new Set();
         for (const term of termsOf(entry)) {
             const normalized = normalizeVocabularyName(term.name);
@@ -48,18 +31,37 @@ export const matchProjectCandidates = (catalog, input) => {
                 if (!pattern.test(text))
                     continue;
                 if (matches.length === 20) {
-                    omittedMatches++;
+                    omitted++;
                     continue;
                 }
                 matches.push({ term, source, ambiguous: (owners.get(normalized)?.size ?? 0) > 1 });
             }
         }
         if (matches.length)
-            result.push({
-                project: { reference: `project:${entry.id}`, id: entry.id, name: entry.name, key: entry.key },
-                matches,
-                omittedMatches,
-            });
+            result.push({ entry, matches, omitted });
     }
-    return result.sort((a, b) => Number(a.project.id) - Number(b.project.id));
+    return result.sort((a, b) => Number(a.entry.id) - Number(b.entry.id));
 };
+export const matchProjectCandidates = (catalog, input) => matchVocabularyTerms(catalog, [
+    ...(input.title === undefined
+        ? []
+        : [
+            {
+                text: input.title,
+                source: { kind: "metadata-title", reference: input.reference, fingerprint: null, revision: null },
+            },
+        ]),
+    ...(input.cues ?? []).map((cue) => ({
+        text: cue.text,
+        source: {
+            kind: "transcript",
+            reference: cue.reference,
+            fingerprint: cue.fingerprint,
+            revision: cue.revision,
+        },
+    })),
+]).map(({ entry, matches, omitted }) => ({
+    project: { reference: `project:${entry.id}`, id: entry.id, name: entry.name, key: entry.key },
+    matches: matches.map(({ term, source, ambiguous }) => ({ term, source, ambiguous })),
+    omittedMatches: omitted,
+}));

package/dist/services/project-gathering-around.d.ts

@@ -1,3 +1,4 @@
+import type { MessageStore } from "../store/index.js";
 import type { MessagesStore } from "../store/messages.js";
 export interface ProjectNeighbour {
     ref: string;
@@ -6,7 +7,7 @@ export interface ProjectNeighbour {
     text: string;
     found: boolean;
 }
-/** The stored messages next to a hit in its chat, oldest first, without the hit itself. */
+/** The stored messages or emails next to a hit, oldest first, without the hit itself. */
 export interface ProjectNeighbourReader {
     around(ref: string, window: {
         before: number;
@@ -35,3 +36,5 @@ export declare const attachNeighbours: (items: {
     remaining: () => number;
     charge: (bytes: number) => void;
 }, known: (ref: string) => boolean, signal?: AbortSignal) => Promise<void>;
+/** Chat messages next to a hit in its chat, and the emails before and after a mail hit in its thread. */
+export declare const storedNeighbours: (store: Pick<MessageStore, "messages" | "mail" | "accounts">) => ProjectNeighbourReader;

package/dist/services/project-gathering-around.js

@@ -4,6 +4,8 @@ import { excerpt } from "./excerpt.js";
 export const storedMessageNeighbours = (messages) => ({
     async around(ref, window) {
         const at = parseLocator(ref);
+        if (at.provider === "email")
+            return [];
         const rows = await messages.around({ provider: at.provider, account: at.account }, at.chat, at.message, window);
         return rows
             .filter((row) => !row.anchor)
@@ -23,7 +25,7 @@ export const attachNeighbours = async (items, reader, window, budget, known, sig
     if (!reader || window.before + window.after === 0)
         return;
     for (const item of items) {
-        if (item.kind !== "message")
+        if (item.kind !== "message" && item.kind !== "mail")
             continue;
         if (budget.remaining() <= 0) {
             item.around = null;
@@ -55,3 +57,32 @@ export const attachNeighbours = async (items, reader, window, budget, known, sig
         }
     }
 };
+/** Chat messages next to a hit in its chat, and the emails before and after a mail hit in its thread. */
+export const storedNeighbours = (store) => {
+    const messages = storedMessageNeighbours(store.messages);
+    return {
+        async around(ref, window) {
+            const at = parseLocator(ref);
+            if (at.provider !== "email")
+                return messages.around(ref, window);
+            const account = await store.accounts.storedAccount({ provider: at.provider, account: at.account });
+            const email = await store.mail.email(account.id, at.message);
+            if (!email)
+                throw new CliError("not_found", "the hit's email is no longer stored");
+            const thread = await store.mail.thread(email.emailThreadId);
+            const emails = thread?.emails ?? [];
+            const index = emails.findIndex((one) => one.id === email.id);
+            if (index < 0)
+                return [];
+            return [
+                ...emails.slice(Math.max(0, index - window.before), index),
+                ...emails.slice(index + 1, index + 1 + window.after),
+            ].map((one) => ({
+                ref: formatLocator({ ...at, message: one.externalId }),
+                at: one.sentAt ?? one.receivedAt ?? 0,
+                sender: one.fromName ?? one.fromAddress,
+                text: [one.subject, one.bodyText ?? one.snippet].filter(Boolean).join(" — "),
+            }));
+        },
+    };
+};

package/dist/services/project-gathering-mentions.d.ts

@@ -0,0 +1,44 @@
+import type { VocabularyKind, VocabularyStore } from "../store/index.js";
+import { type VocabularyTerm } from "./meeting-project-candidate-matching.js";
+import type { ProjectGathering } from "./project-gathering.js";
+export interface EvidenceMention {
+    target: {
+        kind: VocabularyKind;
+        id: string;
+        reference: string;
+        name: string;
+        key: string | null;
+    };
+    matches: {
+        term: VocabularyTerm;
+        ambiguous: boolean;
+        reference: string;
+        in: "hit" | "around";
+    }[];
+    omittedMatches: number;
+}
+export interface EvidenceMentions {
+    kind: "evidence_mentions";
+    association: "unconfirmed-literal-evidence";
+    items: EvidenceMention[];
+    vocabularyFingerprints: Partial<Record<VocabularyKind, string>>;
+    coverage: {
+        texts: "returned-excerpts";
+        matching: "unicode-normalized-literal-word-boundaries";
+        hasMore: boolean;
+        skipped: {
+            kind: VocabularyKind;
+            code: string;
+            reason: string | null;
+        }[];
+    };
+}
+/**
+ * Which existing projects, tags and topics the returned excerpts and their neighbours name. A name is evidence to
+ * review, never membership; the gathered project itself is left out.
+ */
+export declare const findEvidenceMentions: (vocabulary: Pick<VocabularyStore, "vocabulary">, gathering: Pick<ProjectGathering, "items">, options?: {
+    exclude?: string | null;
+    limit?: number;
+    signal?: AbortSignal;
+}) => Promise<EvidenceMentions>;

package/dist/services/project-gathering-mentions.js

@@ -0,0 +1,60 @@
+import { CliError } from "@wirecat/cli-base";
+import { matchVocabularyTerms } from "./meeting-project-candidate-matching.js";
+const KINDS = ["project", "tag", "topic"];
+/**
+ * Which existing projects, tags and topics the returned excerpts and their neighbours name. A name is evidence to
+ * review, never membership; the gathered project itself is left out.
+ */
+export const findEvidenceMentions = async (vocabulary, gathering, options = {}) => {
+    if (typeof vocabulary?.vocabulary !== "function")
+        throw new CliError("configuration_error", "evidence mentions need the store's vocabulary");
+    const limit = options.limit ?? 50;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 200)
+        throw new CliError("validation_error", "limit must be a whole number from 1 to 200", { param: "limit" });
+    const texts = gathering.items.flatMap((item) => [
+        { text: `${item.title ?? ""} ${item.text}`, source: { reference: item.ref, in: "hit" } },
+        ...(item.around ?? []).map((one) => ({ text: one.text, source: { reference: one.ref, in: "around" } })),
+    ]);
+    const items = [];
+    const vocabularyFingerprints = {};
+    const skipped = [];
+    for (const kind of KINDS) {
+        options.signal?.throwIfAborted();
+        let catalog;
+        try {
+            catalog = await vocabulary.vocabulary({ kind, signal: options.signal });
+        }
+        catch (error) {
+            options.signal?.throwIfAborted();
+            if (!(error instanceof CliError))
+                throw error;
+            const reason = error.details?.reason;
+            skipped.push({ kind, code: error.code, reason: typeof reason === "string" ? reason : null });
+            continue;
+        }
+        vocabularyFingerprints[kind] = catalog.fingerprint;
+        for (const { entry, matches, omitted } of matchVocabularyTerms(catalog, texts)) {
+            const reference = `${kind}:${entry.id}`;
+            if (reference === options.exclude)
+                continue;
+            items.push({
+                target: { kind, id: entry.id, reference, name: entry.name, key: entry.key },
+                matches: matches.map(({ term, source, ambiguous }) => ({ term, ambiguous, ...source })),
+                omittedMatches: omitted,
+            });
+        }
+    }
+    items.sort((a, b) => b.matches.length - a.matches.length);
+    return {
+        kind: "evidence_mentions",
+        association: "unconfirmed-literal-evidence",
+        items: items.slice(0, limit),
+        vocabularyFingerprints,
+        coverage: {
+            texts: "returned-excerpts",
+            matching: "unicode-normalized-literal-word-boundaries",
+            hasMore: items.length > limit,
+            skipped,
+        },
+    };
+};

package/dist/terminal/login-qr.d.ts

@@ -19,8 +19,11 @@ export interface LoginQrOptions {
 }
 export interface LoginQr {
     readonly path: string | undefined;
-    /** Never throws for a code that does not fit: the messengers call it from inside their own event loops. */
-    show: (link: string) => void;
+    /**
+     * `scan` says where to scan; it follows the code, and is not said when the terminal is too narrow to draw one.
+     * Never throws for a code that does not fit: the messengers call it from inside their own event loops.
+     */
+    show: (link: string, scan?: string) => void;
     /** The image logs the account in while it is valid; call this in `finally`. */
     close: () => void;
 }

package/dist/terminal/login-qr.js

@@ -17,11 +17,13 @@ export const loginQr = ({ qrFile, diagnostic, note, indent: pad = 0, columns = (
     let written = false;
     return {
         path,
-        show: (link) => {
+        show: (link, scan) => {
             if (path) {
                 writeSecurely(path, qrPng(link), 0o600);
                 written = true;
                 note(`the QR code is in ${path} — it is replaced when the code renews`);
+                if (scan)
+                    note(scan);
                 return;
             }
             const drawn = terminalQr(link);
@@ -33,6 +35,8 @@ export const loginQr = ({ qrFile, diagnostic, note, indent: pad = 0, columns = (
                 return;
             }
             diagnostic(`\n${indent(drawn.text, pad + MARGIN)}`);
+            if (scan)
+                note(scan);
         },
         close: () => {
             if (!path || !written)

package/package.json

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