@wirecat/cli-core 0.379.0 → 0.381.0

package/CHANGELOG.md

@@ -7,6 +7,91 @@ shape of this file.
 
 ## Unreleased
 
+## 0.381.0 — 22.10.2026
+
+### Added
+
+- **Meeting search finds words speech recognition cut off.** A stored word of four letters or more that begins a
+  query word, and that the Russian dictionary does not know, widens it: «може» for «может», «напри» for «например».
+  Real shorter words («после» for «последующих») still do not. This is ztx's rule, behind the dictionary.
+
+- **People's reactions in the store (store version 26).** For a messenger that sends one person's reaction change at a
+  time (WhatsApp), a `watch` event `{ event: "person_reaction", chatId, chatTitle, messageId, reaction }`
+  (`PersonReactionEvent`) and a pushed batch's `reactions` (`HistoryReaction`) carry `PersonReaction`
+  (`{ person, own, reaction, reactedAt }`, `reaction: null` a take-back). `store.messages.saveReaction` and
+  `saveMessages({ reactions })` keep each person's newest in the new `message_reactions` table, so an older history
+  push never undoes a newer live change, and write the message's `reactions` totals from them: readers, output and
+  MCP see the same shape. tg and max keep sending totals; a message with people's reactions keeps the derived ones.
+  See [adapters](docs/dev/ADAPTERS.md).
+
+### Fixed
+
+- **A chat or person is found by a name copied with its emoji.** A copied emoji often carries an invisible mark
+  (U+FE0F, U+FE0E, or the U+200D joiner) that a typed one lacks, so "Семья❤️" did not find the chat "Семья❤". Names
+  now compare without those marks and with accented letters in one form, still ignoring case, wherever a chat or a
+  person is named (`pickChat`, `pickPerson`, a stored alias).
+- **A store the process may not write is a permission error, not a crash.** Opening the store for writing where the
+  file or its folder is read-only (`EROFS`, `EACCES`, `EPERM`) was reported as `internal_error` "this is a bug".
+  It is now `permission_error` (exit 5) with reason `store.not-writable`, and the message names no path.
+
+## 0.380.0 — 21.10.2026
+
+### Added
+
+- **A file's copy and the provider's copy of one meeting are one record.** `MeetingSave.fromFile` marks a save read
+  from a file; it joins the provider's record of the same occurrence (same series key, start within 15 minutes)
+  and only fills a missing transcript there. A provider record saved after a file takes over that record and its
+  key, and a provider transcript supersedes transcripts with source `file`. Two provider records never merge.
+  See [meetings](docs/dev/MEETINGS.md).
+- **Meetings import text transcripts.** `parseTranscriptText` reads the text form zoom-searcher wrote: the header
+  (`Встреча:` title, `Дата:` start as written, `Zoom ID:`, `Говорят:` speakers) and `[hh:mm:ss] Speaker: text`
+  blocks, a block running over several lines. `ImportFile.format: "text"` makes `importFiles` use it; `vtt` stays
+  the default. The file keeps start times only, so a line ends where the next begins.
+- **An import says the zone it read file times in, and a host can explain its file names.** `RunReport.timezone` is
+  set when every imported file's meeting carries one zone; `MeetingCommandDeps.importHelp` adds the host's note
+  (file name patterns, how their time is read) under `meetings import --help`.
+||||||| Stash base
+- **Meeting search finds words spread over neighbouring lines.** `"циан риелтор"~3` in a meeting query finds a
+  transcript line with one of the words when the others are at most three lines away in the same transcript; `~0`
+  is one line, any order; at most 20. The words widen to garbled spellings as single words do. It needs
+  `@wirecat/cli-base` 0.49.0 (`parseLucene({ proximity: true })`), now the pinned version and the peer range.
+  See [query language](docs/search/query-language.md#встречи).
+
+- **Meeting search finds words speech recognition garbled.** `meetings.searchHits` widens each query word of four
+  letters or more to stored words one stem edit away that a Russian dictionary does not know, and to stems one side
+  extends, so «риелтор» finds «реелтора», «рилторов» and «дриелтора», «циана» finds «цианом», and «договор» does not
+  find «поговорить». Hits come typed form first, then other forms, then garbled spellings; a widened hit carries `match: "corrected"` and `corrections`, and `meeting_hit` items show both. Number words never
+  widen, and match only their own forms («семь» finds «семи», not «семьдесят»). See [meetings](docs/dev/MEETINGS.md).
+- **Answers say which zone a typed date was read in, and the UTC window it gave** (cli-base `WC-TIME-3`, `WC-TIME-5`).
+  `stats charts`, the MCP `stats` tool and `contacts timeline` put `meta.timezone` (only when a value had no zone of
+  its own) and `meta.window: { since?, until? }` in UTC in their answers. `dateWindow` in `./cli`'s moment helpers
+  builds both from `--since-time`/`--until-time`. Other date filters follow.
+
+### Changed — may break callers
+
+- **Meeting search reads the messages query language.** `meetings.searchHits`, `search meetings` and MCP
+  `search_meetings` take `OR`, `(groups)`, `NOT`/`-word`, `"phrases"` (neighbouring words, any form), `exact:` and
+  `from:"Name"` — who said the line or wrote the chat message, a person through all their linked identities; an
+  ambiguous name is an error with the candidates. `:`, `(`, `"`, `-` and `AND`/`OR`/`NOT` in a meeting query are
+  now syntax, and a query of punctuation alone is a `validation_error`. `searchHits` also takes a `QueryAst`;
+  `meetingWordsQuery(text)` builds one from text that must stay plain words, as project discovery now does.
+  `MEETING_HIT_QUERY` and `parseMeetingQuery` are exported. See [query language](docs/search/query-language.md#встречи).
+
+- **Meeting search reads `exact:` and has new cursors.** `exact:word` and `exact:"two words"` in a
+  `meetings.searchHits` query keep those words to their typed form, where `exact` was a search word before. Exact
+  hits now come before widened ones, so cursors from earlier versions are refused; start the search again.
+
+### Fixed
+
+- **A recording archive schedule counts "today" in its own zone.** The window's end, its ten-year floor and its
+  look-back started from the UTC date, so a run between local midnight and UTC midnight worked on yesterday. The
+  schedule's `timeZone` was stored and never used for this.
+- **A Markdown chat archive says which zone its times are in.** The file printed local wall times with no zone; it
+  now has `Times are in <zone>.` under the title.
+- **`chats stats show` and `stats chats retention` read `--since-time`/`--until-time` in their `--timezone`.** They
+  used the computer's zone even when `--timezone` was given, and retention's `--until-time` dropped the day it named;
+  it now covers that whole local day.
+
 ## 0.379.0 — 21.10.2026
 
 ### Changed — may break callers

package/dist/cli/bot/watch.js

@@ -131,7 +131,7 @@ export const botWatchCommand = (bot) => annotate(new Command("watch"), { effects
         else if (event.event === "delete") {
             context.streams.data(`deleted in ${title(event.chatId)}: message ${event.messageId}\n`);
         }
-        else if (event.event === "reaction") {
+        else if (event.event === "reaction" || event.event === "person_reaction") {
             context.streams.data(`reactions in ${title(event.chatId)} on message ${event.messageId}\n`);
         }
         else if (event.event === "vote") {

package/dist/cli/index.d.ts

@@ -11,7 +11,7 @@ export { callMeetingSeriesInventoryTool, meetingSeriesInventoryTool } from "../m
 export { registerLinkConversationsPrompt } from "../mcp/prompts.js";
 export { agentBody, agentJson, agentResult, UNTRUSTED, UNTRUSTED_INSTRUCTION } from "../mcp/text.js";
 export { type AppIdentity, envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
-export type { AccountEditing, AccountHealth, AccountRecords, AccountSettings, AccountStanding, AccountTools, After, BotChats, ChannelComments, ChatDeletion, ChatFolders, ChatReading, ContactBook, Download, ForumControl, ForumState, GroupAdmin, GroupModeration, HistoryBatch, HistoryChatEvent, HistoryStar, HistoryVote, InviteLinks, JoinRequests, LiveUpdates, MessageButtons, MessageEditing, MessageMedia, MessagePermalinks, MessagePins, MessagePolls, MessageReactions, MessageSearch, MessageStars, MessengerAdapter, MessengerCore, NewPoll, OfficialStats, PassiveUpdates, PersonProfiles, ProfileChange, ProfilePhotos, PushedHistory, ReadState, RemoteFile, ScheduledMessages, SenderIdentities, SenderSearch, SendOptions, Sent, ServerQuery, ServerReads, ThreadAddressing, TopicEditing, TopicHistory, TopicReadState, Transcript, } from "../ports/messenger.js";
+export type { AccountEditing, AccountHealth, AccountRecords, AccountSettings, AccountStanding, AccountTools, After, BotChats, ChannelComments, ChatDeletion, ChatFolders, ChatReading, ContactBook, Download, ForumControl, ForumState, GroupAdmin, GroupModeration, HistoryBatch, HistoryChatEvent, HistoryReaction, HistoryStar, HistoryVote, InviteLinks, JoinRequests, LiveUpdates, MessageButtons, MessageEditing, MessageMedia, MessagePermalinks, MessagePins, MessagePolls, MessageReactions, MessageSearch, MessageStars, MessengerAdapter, MessengerCore, NewPoll, OfficialStats, PassiveUpdates, PersonProfiles, ProfileChange, ProfilePhotos, PushedHistory, ReadState, RemoteFile, ScheduledMessages, SenderIdentities, SenderSearch, SendOptions, Sent, ServerQuery, ServerReads, ThreadAddressing, TopicEditing, TopicHistory, TopicReadState, Transcript, } from "../ports/messenger.js";
 export type { Fetching, MediaOption, MessengerTraits } from "../ports/traits.js";
 export { senderFacts } from "../replies/dry-run.js";
 export { type ReplyRender, replyRenderer } from "../replies/rendering.js";

package/dist/cli/meeting-preparation-answer.d.ts

@@ -309,6 +309,11 @@ export declare const meetingPreparationAnswer: (packet: MeetingPreparation) => i
                 id: string;
                 excerpt: string;
                 offset_ms: number | null;
+                match?: "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 source?: {
                     ref: string;
                     title: string | null;

package/dist/cli/meeting-preparation-projects.d.ts

@@ -29,6 +29,11 @@ export declare const mapPreparationProjectEvidence: (section: NonNullable<Meetin
             id: string;
             excerpt: string;
             offset_ms: number | null;
+            match?: "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             source?: {
                 ref: string;
                 title: string | null;

package/dist/cli/meeting-preparation-read.d.ts

@@ -338,6 +338,11 @@ export declare const readMeetingPreparation: (read: MeetingPreparationReader, in
                 id: string;
                 excerpt: string;
                 offset_ms: number | null;
+                match?: "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 source?: {
                     ref: string;
                     title: string | null;

package/dist/cli/messenger/chats-stats-command.js

@@ -21,7 +21,11 @@ export const statsCommand = (messenger) => annotate(new Command("show"), { effec
     refuseJsonl(context.format);
     const { stats, account } = await context.withServices(async (services) => ({
         stats: await services.chats.stats(chat, {
-            ...(sinceTime === undefined ? {} : { since: momentOf(sinceTime, "--since-time") }),
+            ...(sinceTime === undefined
+                ? {}
+                : {
+                    since: momentOf(sinceTime, "--since-time", Date.now(), timezone === undefined ? {} : { zone: timezone }),
+                }),
             ...(by ? { by } : {}),
             ...(timezone === undefined ? {} : { timezone }),
         }),

package/dist/cli/messenger/contacts-command.js

@@ -4,7 +4,7 @@ import { Command } from "commander";
 import { REGISTRIES, registriesCover } from "../../botcheck/registries.js";
 import { levelFor } from "../../sends/permissions.js";
 import { phoneOf } from "../../services/index.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow, momentOf } from "../../services/moment.js";
 import { maskedAccount } from "../../services/people.js";
 import { CHAT_MESSAGES, CONTEXT_BYTES, CONTEXT_MESSAGES } from "../../services/person-context.js";
 import { SCOPES, TIMELINE_ITEMS } from "../../services/person-timeline.js";
@@ -150,10 +150,14 @@ export const contactsCommand = (messenger) => {
         if (scope !== undefined && !SCOPES.includes(scope))
             throw new CliError("validation_error", `--scope is personal or work, not "${scope}"`);
         const context = messengerContext(this, messenger);
+        const window = dateWindow({
+            ...(sinceTime === undefined ? {} : { sinceTime }),
+            ...(untilTime === undefined ? {} : { untilTime }),
+        });
         const found = await context.withServices((services) => services.people.timeline(person, {
             ...(scope === undefined ? {} : { scope: scope }),
-            ...(sinceTime === undefined ? {} : { since: momentOf(sinceTime, "--since-time") }),
-            ...(untilTime === undefined ? {} : { until: momentOf(untilTime, "--until-time", Date.now(), { end: true }) }),
+            ...(window.since === undefined ? {} : { since: window.since }),
+            ...(window.until === undefined ? {} : { until: window.until }),
             ...(limit === undefined ? {} : { limit }),
             ...(cursor === undefined ? {} : { cursor }),
         }));
@@ -170,7 +174,7 @@ export const contactsCommand = (messenger) => {
                 ...(sinceTime === undefined ? {} : { since_time: sinceTime }),
                 ...(untilTime === undefined ? {} : { until_time: untilTime }),
             },
-            ...(pending > 0 ? { meta: { truncated: true } } : {}),
+            meta: { ...window.meta, ...(pending > 0 ? { truncated: true } : {}) },
         }));
     });
     annotate(contacts.command("check"), { effects: REMOTE_READ })

package/dist/cli/messenger/stats-answers.d.ts

@@ -1,3 +1,4 @@
+import type { Meta } from "@wirecat/cli-base/standards";
 import type { InferOutput } from "valibot";
 import type { ChartData } from "../../charts/model.js";
 import type { CounterState } from "../../domain/counters.js";
@@ -62,7 +63,7 @@ export declare const chartAnswer: (chart: ChartData, file?: {
     format: "svg" | "png";
     width: number;
     height: number;
-}) => ItemBody<Of<"chart">>;
+}, meta?: Partial<Meta>) => ItemBody<Of<"chart">>;
 /** A report or a chart is one object: `--jsonl` would print one line pretending to be a stream. */
 export declare const refuseJsonl: (format: string) => void;
 /** `stats chats show`, CLI and MCP alike; a chat the store does not hold whole names the sync that fills it. */

package/dist/cli/messenger/stats-answers.js

@@ -326,7 +326,7 @@ export const officialAnswer = (stats, provider) => {
         graphs: stats.graphs,
     }));
 };
-export const chartAnswer = (chart, file) => itemOf(defined({ ...chart, file }));
+export const chartAnswer = (chart, file, meta) => itemOf(defined({ ...chart, file }), meta ? { meta } : {});
 /** A report or a chart is one object: `--jsonl` would print one line pretending to be a stream. */
 export const refuseJsonl = (format) => {
     if (format === "jsonl")

package/dist/cli/messenger/stats-command.js

@@ -9,7 +9,7 @@ import { CHART_SIZE } from "../../charts/model.js";
 import { chartPng } from "../../charts/png.js";
 import { chartRenderer } from "../../charts/render.js";
 import { EVENTS_DAYS } from "../../services/chats.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { destroysNothing, LOCAL_WRITE } from "../effects.js";
 import { renderAnswer } from "../envelope.js";
 import { adminStatisticsCommand } from "./admin-statistics-command.js";
@@ -61,13 +61,8 @@ export const statsCommand = (messenger, loadRenderer = chartRenderer) => {
             throw new CliError("validation_error", "--output takes a .svg or .png file; image output to stdout is unavailable");
         }
         const timezone = timezoneOf(given);
-        const found = await context.withServices((services) => services.chats.stats(chat, {
-            by,
-            timezone,
-            ...(sinceTime === undefined
-                ? {}
-                : { since: momentOf(sinceTime, "--since-time", Date.now(), { zone: timezone }) }),
-        }));
+        const window = dateWindow({ ...(sinceTime === undefined ? {} : { sinceTime }), zone: timezone });
+        const found = await context.withServices((services) => services.chats.stats(chat, { by, timezone, ...(window.since === undefined ? {} : { since: window.since }) }));
         const chart = chatChart(found, { kind: chartKind, by, timezone });
         let chartFile;
         if (output !== undefined) {
@@ -87,7 +82,7 @@ export const statsCommand = (messenger, loadRenderer = chartRenderer) => {
         }
         if (chart.partial)
             context.renderer.note("partial data — the chart shows lower bounds");
-        renderAnswer(this, context, chartAnswer(chart, chartFile));
+        renderAnswer(this, context, chartAnswer(chart, chartFile, window.meta));
     });
     return stats;
 };

package/dist/cli/messenger/stored.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { capability, throughWrapper } from "../../ports/messenger.js";
-import { isId, pickPerson } from "../../resolve.js";
+import { foldName, isId, pickPerson } from "../../resolve.js";
 import { codeOf } from "../../sends/guarded.js";
 import { chatIdIn } from "../../services/message-resolution.js";
 const REKEY_PACING = { lockMs: 50, pauseMs: 25 };
@@ -212,8 +212,8 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
             const { id, held } = namesFromStore ? await storedChat(opened, scoped, namesFromStore, reference) : {};
             if (!isId(reference)) {
                 const people = await opened.people.people(scoped.provider, { account: scoped.account });
-                const wanted = reference.trim().toLowerCase();
-                if (people.all().some((person) => person.alias?.toLowerCase().includes(wanted))) {
+                const wanted = foldName(reference.trim());
+                if (people.all().some((person) => person.alias && foldName(person.alias).includes(wanted))) {
                     const person = pickPerson(reference, people);
                     const chats = (await opened.chats.chatsWith(scoped, person.id)).filter((chat) => chat.kind === "dialog");
                     if (chats.length !== 1 || !chats[0])
@@ -517,7 +517,7 @@ const fill = async (store, account, batch) => {
         await store.people.savePeople(account, batch.people);
     const byChat = new Map();
     const of = (chatId) => {
-        const held = byChat.get(chatId) ?? { messages: [], votes: [], stars: [] };
+        const held = byChat.get(chatId) ?? { messages: [], votes: [], reactions: [], stars: [] };
         byChat.set(chatId, held);
         return held;
     };
@@ -525,10 +525,12 @@ const fill = async (store, account, batch) => {
         of(message.chatId).messages.push(message);
     for (const { chatId, messageId, vote } of batch.votes ?? [])
         of(chatId).votes.push({ messageId, vote });
+    for (const { chatId, messageId, reaction } of batch.reactions ?? [])
+        of(chatId).reactions.push({ messageId, reaction });
     for (const { chatId, messageId, starred } of batch.stars ?? [])
         of(chatId).stars.push({ messageId, starred });
-    for (const [chatId, { messages, votes, stars }] of byChat)
-        await store.messages.saveMessages(account, chatId, messages, { via: "history", votes, stars });
+    for (const [chatId, { messages, votes, reactions, stars }] of byChat)
+        await store.messages.saveMessages(account, chatId, messages, { via: "history", votes, reactions, stars });
     const changes = new Map();
     for (const { chatId, change } of batch.events ?? [])
         changes.set(chatId, [...(changes.get(chatId) ?? []), change]);
@@ -537,7 +539,7 @@ const fill = async (store, account, batch) => {
 };
 /**
  * Each change as the store keeps it: a message or an edit upserted, a deletion a tombstone, reactions replaced, a
- * voter's vote replacing their older one, a star set or taken off, a chat event kept once.
+ * voter's vote or a person's reaction replacing their older one, a star set or taken off, a chat event kept once.
  */
 const keep = async (store, account, event, seenAt, among) => {
     switch (event.event) {
@@ -553,6 +555,9 @@ const keep = async (store, account, event, seenAt, among) => {
         case "vote":
             await store.messages.saveVote(account, event.chatId, event.messageId, event.vote);
             return;
+        case "person_reaction":
+            await store.messages.saveReaction(account, event.chatId, event.messageId, event.reaction);
+            return;
         case "star":
             await store.messages.saveStar(account, event.chatId, event.messageId, event.starred);
             return;

package/dist/cli/messenger/watch-command.js

@@ -110,6 +110,12 @@ const describe = (event, render) => {
             const choice = answers.length > 0 ? answers.join(", ") : "took it back";
             return `vote in ${event.chatTitle ?? event.chatId} on poll ${event.messageId}: ${person.name ?? person.id} — ${choice}\n`;
         }
+        case "person_reaction": {
+            const { person, reaction } = event.reaction;
+            const who = person.name ?? person.id;
+            const what = reaction === null ? "took their reaction back" : `reacted ${reaction}`;
+            return `${who} ${what} in ${event.chatTitle ?? event.chatId} on message ${event.messageId}\n`;
+        }
         case "star":
             return `${event.starred ? "starred" : "unstarred"} in ${event.chatTitle ?? event.chatId}: message ${event.messageId}\n`;
         case "chat_event": {

package/dist/domain/models.d.ts

@@ -263,6 +263,19 @@ export interface Reactions {
     mine: string | null;
     total: number;
 }
+/**
+ * One person's reaction to a message, for a messenger that sends a reaction change at a time (WhatsApp) instead of
+ * totals. `reaction` is `null` when they took it back. The store keeps each person's newest by `reactedAt` and derives
+ * the message's `Reactions` from them.
+ */
+export interface PersonReaction {
+    person: Member;
+    /** The owner's own reaction, which becomes `Reactions.mine`. */
+    own: boolean;
+    reaction: string | null;
+    /** ISO 8601 — when the person reacted, as the messenger says, not when it arrived. */
+    reactedAt: string;
+}
 /** The message a reply answers or a forward carries. */
 export interface QuotedMessage {
     id: Id;
@@ -384,6 +397,14 @@ export interface PollVoteEvent {
     messageId: Id;
     vote: PollVote;
 }
+/** One person reacted to `messageId`, changed their reaction, or took it back; saved, an older one never wins. */
+export interface PersonReactionEvent {
+    event: "person_reaction";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+    reaction: PersonReaction;
+}
 /** The owner starred a message or took the star off, here or on another device; saved, the same twice is one. */
 export interface MessageStarEvent {
     event: "star";
@@ -399,11 +420,11 @@ export interface ChatEventNotice {
     chatTitle: string | null;
     change: ChatEvent;
 }
-/** What a listening connection reports: a new message, a change to one, a vote, a star, or a change to a chat. */
+/** What a listening connection reports: a new message, a change to one, a vote, a reaction, a star, or a change to a chat. */
 export type MessageEvent = {
     event: "message";
     message: MessageHit;
-} | MessageChange | PollVoteEvent | MessageStarEvent | ChatEventNotice;
+} | MessageChange | PollVoteEvent | PersonReactionEvent | MessageStarEvent | ChatEventNotice;
 /** One chat's share of `inbox`: other people's messages since the last check, oldest first. */
 export interface InboxChat extends Pick<Chat, "id" | "title" | "kind" | "unreadCount"> {
     messages: Message[];

package/dist/entities/index.d.ts

@@ -2106,6 +2106,11 @@ export declare const ENTITIES: {
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
         readonly excerpt: v.StringSchema<undefined>;
         readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly source: v.OptionalSchema<v.StrictObjectSchema<{
             readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
             readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -2257,6 +2262,11 @@ export declare const ENTITIES: {
             readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
             readonly excerpt: v.StringSchema<undefined>;
             readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly source: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
                 readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -2614,6 +2624,11 @@ export declare const ENTITIES: {
                     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
                     readonly excerpt: v.StringSchema<undefined>;
                     readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                    readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
+                    readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                        readonly from: v.StringSchema<undefined>;
+                        readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                    }, undefined>, undefined>, undefined>;
                     readonly source: v.OptionalSchema<v.StrictObjectSchema<{
                         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
                         readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;

package/dist/entities/meeting-preparation.d.ts

@@ -309,6 +309,11 @@ export declare const meetingPreparation: v.StrictObjectSchema<{
                 readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
                 readonly excerpt: v.StringSchema<undefined>;
                 readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
+                readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly from: v.StringSchema<undefined>;
+                    readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
                 readonly source: v.OptionalSchema<v.StrictObjectSchema<{
                     readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
                     readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;

package/dist/errors/reasons.js

@@ -27,6 +27,7 @@ const OTHERS = [
     validation("file.locked", "another process holds the file's lock"),
     ["profile.wrong-account", "authentication_error", "the signed-in source account does not match this profile"],
     validation("store.refused", "the local store refused the document text"),
+    ["store.not-writable", "permission_error", "the message store cannot be written from this process"],
     validation("catalog.scope-limit", "the selected catalog exceeds its entry limit"),
     validation("evidence.row-too-large", "one evidence row is over its size limit"),
     validation("index.not-ready", "the search index is still being built"),

package/dist/mcp/meeting-preparation.d.ts

@@ -376,6 +376,11 @@ export declare const callMeetingPreparationTool: (read: MeetingPreparationReader
                     id: string;
                     excerpt: string;
                     offset_ms: number | null;
+                    match?: "corrected" | "words" | undefined;
+                    corrections?: {
+                        from: string;
+                        to: string[];
+                    }[] | undefined;
                     source?: {
                         ref: string;
                         title: string | null;

package/dist/mcp/tools/stats.js

@@ -7,7 +7,7 @@ import { chartRenderer } from "../../charts/render.js";
 import { sealed } from "../../cli/envelope.js";
 import { chartAnswer } from "../../cli/messenger/stats-answers.js";
 import { servicesFor, storedDeps } from "../../services/index.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { chatOf, Picture, READ, tool } from "../tool.js";
 export const statsTools = (messenger) => ({
     stats_charts: tool({
@@ -29,18 +29,21 @@ export const statsTools = (messenger) => ({
         stored: async (store, account, args, defaults) => {
             const timezone = timezoneOf(args.timezone);
             const by = args.by ?? "day";
+            const window = dateWindow({
+                ...(args.since_time === undefined ? {} : { sinceTime: args.since_time }),
+                zone: timezone,
+                names: ["since_time", "until_time"],
+            });
             const stats = await servicesFor(storedDeps(messenger, store, account, defaults.guard)).chats.stats(args.chat, {
                 by,
                 timezone,
-                ...(args.since_time === undefined
-                    ? {}
-                    : { since: momentOf(args.since_time, "since_time", Date.now(), { zone: timezone }) }),
+                ...(window.since === undefined ? {} : { since: window.since }),
             });
             const chart = chatChart(stats, { kind: args.chart_kind ?? "messages", by, timezone });
             if (args.format !== "png")
-                return chartAnswer(chart);
+                return chartAnswer(chart, undefined, window.meta);
             const image = await chartPng(await (await chartRenderer()).render(chart, CHART_SIZE));
-            return new Picture(image.bytes, image.mimeType, sealed(chartAnswer(chart)));
+            return new Picture(image.bytes, image.mimeType, sealed(chartAnswer(chart, undefined, window.meta)));
         },
     }),
 });

package/dist/meetings/answers.d.ts

@@ -15,6 +15,12 @@ export declare const meetingHit: v.StrictObjectSchema<{
     readonly excerpt: v.StringSchema<undefined>;
     /** How far into the meeting the passage is. */
     readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    /** `corrected`: a query word matched only a garbled form of itself, listed in `corrections`. */
+    readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
+    readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly from: v.StringSchema<undefined>;
+        readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     readonly source: v.OptionalSchema<v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;

package/dist/meetings/answers.js

@@ -16,6 +16,9 @@ export const meetingHit = v.strictObject({
     excerpt: text,
     /** How far into the meeting the passage is. */
     offset_ms: v.nullable(count),
+    /** `corrected`: a query word matched only a garbled form of itself, listed in `corrections`. */
+    match: v.optional(v.picklist(["words", "corrected"])),
+    corrections: v.optional(v.array(v.strictObject({ from: text, to: v.array(text) }))),
     source: v.optional(v.strictObject({
         ref: reference,
         title: v.nullable(text),
@@ -185,6 +188,8 @@ export const meetingHitItem = (hit) => ({
     id: String(hit.id),
     excerpt: hit.text,
     offset_ms: hit.startMs,
+    ...(hit.match === undefined ? {} : { match: hit.match }),
+    ...(hit.corrections === undefined ? {} : { corrections: hit.corrections }),
     ...(hit.source === undefined
         ? {}
         : {

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

@@ -7,6 +7,8 @@ export interface MeetingCommandDeps {
     accountId: number;
     source?: MeetingSource;
     readFiles?: (folder: string) => Promise<ImportFile[]>;
+    /** The host's file names and how it reads their time, shown in `meetings import --help`. */
+    importHelp?: string;
     writeFile?: (path: string, content: string) => Promise<void>;
     write: (value: unknown, format: "json" | "jsonl" | "text") => void;
     now?: () => number;

package/dist/meetings/cli/index.js

@@ -122,9 +122,12 @@ export const addMeetingCommands = (program, deps) => {
             lookbackMs: opts.lookbackDays * 86400000,
         }), command);
     });
-    output(annotate(group.command("import"), { effects: LOCAL_WRITE })
+    const importCommand = annotate(group.command("import"), { effects: LOCAL_WRITE })
         .description("import downloaded meeting transcripts")
-        .argument("<folder>", "folder of transcripts downloaded from the provider")).action(async (folder, _opts, command) => {
+        .argument("<folder>", "folder of transcripts downloaded from the provider");
+    if (deps.importHelp)
+        importCommand.addHelpText("after", `\n${deps.importHelp}`);
+    output(importCommand).action(async (folder, _opts, command) => {
         if (!deps.readFiles)
             throw new MeetingError("configuration_error", "file reader is unavailable");
         const files = await deps.readFiles(folder);

package/dist/meetings/cli/search.js

@@ -28,7 +28,7 @@ export const createMeetingSearchCommand = (program) => {
     const command = search
         .command("meetings")
         .description("find words in stored meetings, indexing new ones first")
-        .argument("<query>", "words to find; each also matches its other word forms")
+        .argument("<query>", 'words, OR, (groups), -word, "a phrase", "a b"~N (within N lines), exact:word, from:"Name" (who said the line); a word also matches its other forms and spellings speech recognition garbled')
         .option("--meeting-id <id>", "only this stored meeting", integer)
         .option("--identity-id <id>", "meetings with this participant identity; does not say who spoke a hit", integer)
         .option("--person-id <id>", "meetings with a participant linked to this person", integer)

package/dist/meetings/hit-query.d.ts

@@ -0,0 +1,12 @@
+import { type QueryAst } from "@wirecat/cli-base/query";
+/** A transcript line holds a sentence or two; further than this is a different part of the meeting. */
+export declare const MOST_LINES_APART = 20;
+/** The messages query language over meeting text: the same fields, a narrower set of operators. */
+export declare const MEETING_HIT_QUERY: import("@wirecat/cli-base/query").QueryRegistry;
+/** What a person typed: the CLI, MCP and batch queries. */
+export declare const parseMeetingQuery: (query: string) => QueryAst;
+/**
+ * Words from a name or a note, never parsed: a project called «C++ (beta)» must not become syntax. Each word is
+ * required, in any form.
+ */
+export declare const meetingWordsQuery: (text: string) => QueryAst;