@wirecat/cli-core 0.380.0 → 0.381.0

package/CHANGELOG.md

@@ -7,10 +7,42 @@ 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
@@ -18,6 +50,7 @@ shape of this file.
 - **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

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/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/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/meetings/import.js

@@ -15,6 +15,7 @@ export const importFiles = async (files, store, now = Date.now()) => {
                 participants: file.participants,
                 transcripts: [await transcriptInput(lines, participants, file.source ?? "file", file.content, format)],
                 now,
+                fromFile: true,
             });
             await linkEvent(store, details, now);
             report.meetings++;

package/dist/meetings/store.d.ts

@@ -36,6 +36,12 @@ export interface MeetingSave {
     summaries?: Omit<NewRecord<Summary>, "meetingId">[];
     attachments?: Omit<NewRecord<Attachment>, "attachableType" | "attachableId">[];
     now: number;
+    /**
+     * A copy of the occurrence read from a file, not from the provider. It joins the provider's record of the same
+     * occurrence — same series, start within 15 minutes — and only fills a missing transcript there; a provider
+     * record saved later takes over a record made from files. Transcripts from files have source `file`.
+     */
+    fromFile?: boolean;
 }
 export interface MeetingDetails {
     meeting: Meeting;

package/dist/ports/messenger.d.ts

@@ -3,7 +3,7 @@ import type { CounterField, CounterObservations } from "../domain/counters.js";
 import type { HtmlFormatting, MarkdownFormatting, TextSpan } from "../domain/formatting.js";
 import type { Markup } from "../domain/markdown.js";
 import type { MessagePermalink } from "../domain/message-link.js";
-import type { Account, AccountSession, AdminRight, Button, CallRecord, Chat, ChatCard, ChatEvent, ChatEvents, ChatUpdate, Discussion, Folder, FolderChange, FolderRules, GroupCard, GroupChange, GroupMember, Id, InviteLink, InviteLinkChange, JoinRequest, LinkTarget, MediaKind, Member, Message, MessageEvent, MessageHit, OfficialChatStats, Page, PersonCard, PhoneBookEntry, Poll, PollVote, PrivacySettings, ProfileFacts, ProviderMetadata, SenderIdentity, Sticker, StickerSet, Topic, TopicChange, WindowedMessage } from "../domain/models.js";
+import type { Account, AccountSession, AdminRight, Button, CallRecord, Chat, ChatCard, ChatEvent, ChatEvents, ChatUpdate, Discussion, Folder, FolderChange, FolderRules, GroupCard, GroupChange, GroupMember, Id, InviteLink, InviteLinkChange, JoinRequest, LinkTarget, MediaKind, Member, Message, MessageEvent, MessageHit, OfficialChatStats, Page, PersonCard, PersonReaction, PhoneBookEntry, Poll, PollVote, PrivacySettings, ProfileFacts, ProviderMetadata, SenderIdentity, Sticker, StickerSet, Topic, TopicChange, WindowedMessage } from "../domain/models.js";
 /** One attachment's bytes, fetched over the adapter's connection when `bytes` is read — so read it before the command closes. */
 export interface RemoteFile {
     kind: string;
@@ -331,6 +331,12 @@ export interface HistoryVote {
     messageId: Id;
     vote: PollVote;
 }
+/** One person's reaction to message `messageId` of `chatId`, as `PersonReactionEvent` has it. */
+export interface HistoryReaction {
+    chatId: Id;
+    messageId: Id;
+    reaction: PersonReaction;
+}
 /** One change to who is in chat `chatId`, or to its title, as `ChatEventNotice` has it. */
 export interface HistoryChatEvent {
     chatId: Id;
@@ -344,8 +350,8 @@ export interface HistoryStar {
 }
 /**
  * What a messenger pushed in one go: any of chats, the people in them, past messages of any chats, votes in
- * their polls, the owner's stars, and changes to who is in them. A vote or a star is saved with its chat's messages,
- * after them, so a message in the same batch is held before its votes and its star.
+ * their polls, each person's reactions, the owner's stars, and changes to who is in them. A vote, a reaction or a star
+ * is saved with its chat's messages, after them, so a message in the same batch is held before them.
  * `rekeys` are chats the messenger now names by another id; they apply first, so the batch's messages under the
  * new id join the chat already stored under the old one.
  */
@@ -358,6 +364,7 @@ export interface HistoryBatch {
     people?: Member[];
     messages?: Message[];
     votes?: HistoryVote[];
+    reactions?: HistoryReaction[];
     stars?: HistoryStar[];
     events?: HistoryChatEvent[];
 }

package/dist/resolve.d.ts

@@ -7,6 +7,12 @@ export interface PeopleLookup {
 }
 /** Shaped like a Telegram or MAX id. Another messenger's ids may be any string, so a miss here is not "not an id". */
 export declare const isId: (reference: string) => boolean;
+/**
+ * A name as matching compares it. A copied emoji often carries a presentation mark (U+FE0F, U+FE0E) or a joiner
+ * (U+200D) the typed one lacks, and a letter may come composed or as letter plus accent; none of that is a different
+ * name.
+ */
+export declare const foldName: (name: string) => string;
 /**
  * A name matched as a fragment — and **an ambiguous one is an error, not a guess**: sending to the
  * wrong conversation is not undoable, so the caller is shown the candidates and asked to be

package/dist/resolve.js

@@ -1,6 +1,15 @@
 import { CliError, singleLine } from "@wirecat/cli-base";
 /** Shaped like a Telegram or MAX id. Another messenger's ids may be any string, so a miss here is not "not an id". */
 export const isId = (reference) => /^-?\d+$/.test(reference.trim());
+/**
+ * A name as matching compares it. A copied emoji often carries a presentation mark (U+FE0F, U+FE0E) or a joiner
+ * (U+200D) the typed one lacks, and a letter may come composed or as letter plus accent; none of that is a different
+ * name.
+ */
+export const foldName = (name) => name
+    .normalize("NFC")
+    .replace(/[\uFE0E\uFE0F\u200D]/g, "")
+    .toLowerCase();
 /**
  * A name matched as a fragment — and **an ambiguous one is an error, not a guess**: sending to the
  * wrong conversation is not undoable, so the caller is shown the candidates and asked to be
@@ -8,8 +17,8 @@ export const isId = (reference) => /^-?\d+$/.test(reference.trim());
  * "Мама" must not quietly take a send meant for "Мама Иванова".
  */
 export const pickChat = (reference, chats) => {
-    const wanted = reference.trim().toLowerCase();
-    const matches = chats.filter((chat) => chat.title?.toLowerCase().includes(wanted));
+    const wanted = foldName(reference.trim());
+    const matches = chats.filter((chat) => chat.title !== null && foldName(chat.title).includes(wanted));
     if (matches.length === 1 && matches[0])
         return matches[0];
     if (matches.length === 0)
@@ -27,9 +36,9 @@ export const pickPerson = (reference, people) => {
         return known;
     if (isId(trimmed))
         throw new CliError("not_found", `no person ${trimmed} in what this account has seen`);
-    const wanted = trimmed.replace(/^@/, "").toLowerCase();
+    const wanted = foldName(trimmed.replace(/^@/, ""));
     const everyone = people.all().toSorted((a, b) => (a.name ?? "").localeCompare(b.name ?? ""));
-    const fields = (person) => [person.alias, person.name, person.username].filter(isPresent).map((one) => one.toLowerCase());
+    const fields = (person) => [person.alias, person.name, person.username].filter(isPresent).map(foldName);
     const exact = everyone.filter((person) => fields(person).includes(wanted));
     const matches = exact.length > 0 ? exact : everyone.filter((person) => fields(person).some((one) => one.includes(wanted)));
     if (matches.length === 1 && matches[0])

package/dist/search/garbled.d.ts

@@ -13,7 +13,8 @@ export declare const plainMatch: (probe: GarbledProbe, word: string, stems: stri
  * stemmer cut differently: a stem one side extends counts only when the other side's word spells the extension
  * out — «циана» (stem `циа`) reaches «цианом» (`циан`), «устав» (`уста`) does not reach «установить» (`установ`).
  * `1` is a spelling recognition may have garbled, compared by stem: «рилторов» is three edits from «риелтор»
- * as a word but one as a stem.
+ * as a word but one as a stem; or a word recognition cut off, of four letters or more, that begins the query word
+ * («може» for «может»), as ztx matched.
  */
 export declare const garbledDistance: (probe: GarbledProbe, word: string, stems: string[]) => number | null;
 /**

package/dist/search/garbled.js

@@ -34,7 +34,8 @@ export const plainMatch = (probe, word, stems) => word.startsWith(probe.literal)
  * stemmer cut differently: a stem one side extends counts only when the other side's word spells the extension
  * out — «циана» (stem `циа`) reaches «цианом» (`циан`), «устав» (`уста`) does not reach «установить» (`установ`).
  * `1` is a spelling recognition may have garbled, compared by stem: «рилторов» is three edits from «риелтор»
- * as a word but one as a stem.
+ * as a word but one as a stem; or a word recognition cut off, of four letters or more, that begins the query word
+ * («може» for «может»), as ztx matched.
  */
 export const garbledDistance = (probe, word, stems) => {
     if (probe.literal.length < SHORTEST_GARBLED || plainMatch(probe, word, stems))
@@ -59,6 +60,8 @@ export const garbledDistance = (probe, word, stems) => {
             if (distance <= 1)
                 best = distance;
         }
+    if (best === null && stored.length >= SHORTEST_GARBLED && literal.startsWith(stored))
+        return 1;
     return best;
 };
 /** `editDistance` from `stem` to the nearest beginning of `word`, or `max + 1` once every beginning is further. */
@@ -88,6 +91,8 @@ const prefixDistance = (stem, word, max) => {
  */
 const worthStemming = (probe, word) => {
     const stored = plain(word);
+    if (stored.length >= SHORTEST_GARBLED && plain(probe.literal).startsWith(stored))
+        return true;
     return probe.stems.some((raw) => {
         const stem = plain(raw);
         if (stem.length >= 3 && stored.startsWith(stem))

package/dist/store/messages.d.ts

@@ -1,5 +1,5 @@
 import type { CounterObservations } from "../domain/counters.js";
-import type { Id, Message, Page, PollVote, Reactions, WindowedMessage } from "../domain/models.js";
+import type { Id, Message, Page, PersonReaction, PollVote, Reactions, WindowedMessage } from "../domain/models.js";
 import { type DocumentLinkMessage } from "./sqlite/document-links.js";
 import type { StoreContext } from "./sqlite/open.js";
 import type { AccountKey, DeletionScope, IngestedVia, MessageFilter, SenderChatStats, StoredHit } from "./types.js";
@@ -10,7 +10,8 @@ export interface AccountMessages {
      * `seenAt` is when the messenger was asked: a message it still returned is not deleted, so a
      * tombstone older than that is lifted. A tombstone set after it stays — the deletion is newer.
      *
-     * `votes` and `stars` are saved after the messages in the same transaction, as `saveVote` and `saveStar` save each.
+     * `votes`, `reactions` and `stars` are saved after the messages in the same transaction, as `saveVote`,
+     * `saveReaction` and `saveStar` save each.
      *
      * `typedChatId` is the id the owner wrote to when the messenger answered `chatId`: a chat row made for `chatId`
      * takes the typed row's title, kind and privacy, and is never more visible than it.
@@ -22,6 +23,10 @@ export interface AccountMessages {
             messageId: Id;
             vote: PollVote;
         }[];
+        reactions?: {
+            messageId: Id;
+            reaction: PersonReaction;
+        }[];
         stars?: {
             messageId: Id;
             starred: boolean;
@@ -89,10 +94,18 @@ export interface AccountMessages {
         chatId?: Id;
         among?: DeletionScope;
     }): Promise<number>;
-    /** A message's reactions as they are now; answers whether the message is held at all. */
+    /**
+     * A message's reactions as they are now; answers whether the message is held at all. Ignored where the store holds
+     * people's own reactions to it (`saveReaction`): the totals come from those.
+     */
     saveReactions(key: AccountKey, chatId: Id, messageId: Id, reactions: Reactions, options?: {
         observation?: CounterObservations["reactions"];
     }): Promise<boolean>;
+    /**
+     * One person's reaction to a message, unless the store holds a newer one of theirs; a `null` reaction is a take-back.
+     * The message's `reactions` become the totals of every person's newest, whenever the message is held.
+     */
+    saveReaction(key: AccountKey, chatId: Id, messageId: Id, reaction: PersonReaction): Promise<void>;
     /** The owner's star on a message, or its removal; answers whether the message is held at all. */
     saveStar(key: AccountKey, chatId: Id, messageId: Id, starred: boolean): Promise<boolean>;
     /** One voter's vote in the poll a message carries, unless the store holds a newer one of theirs; no answers is a take-back. */

package/dist/store/messages.js

@@ -11,7 +11,7 @@ export const accountMessagesOver = (context) => {
     const { database } = context;
     const { accountPk, findAccountPk, findChatPk, chatKeyOf, chatPkFor, answeredChatPk, upsertMessage } = keysOver(context);
     return {
-        saveMessages: async (key, chatId, messages, { via, seenAt, votes = [], stars = [], typedChatId }) => write(database, () => {
+        saveMessages: async (key, chatId, messages, { via, seenAt, votes = [], reactions = [], stars = [], typedChatId }) => write(database, () => {
             const accountKey = accountPk(key);
             const chatKey = typedChatId === undefined ? chatPkFor(accountKey, chatId) : answeredChatPk(accountKey, chatId, typedChatId);
             for (const message of messages) {
@@ -20,6 +20,8 @@ export const accountMessagesOver = (context) => {
             }
             for (const { messageId, vote } of votes)
                 messageWrites.saveVote(context, accountKey, key.provider, chatKey, messageId, vote);
+            for (const { messageId, reaction } of reactions)
+                messageWrites.saveReaction(context, accountKey, key.provider, chatKey, messageId, reaction);
             for (const { messageId, starred } of stars)
                 messageWrites.saveStar(context, chatKey, messageId, starred);
         }),
@@ -83,6 +85,10 @@ export const accountMessagesOver = (context) => {
             });
             return saved;
         },
+        saveReaction: async (key, chatId, messageId, reaction) => write(database, () => {
+            const accountKey = accountPk(key);
+            messageWrites.saveReaction(context, accountKey, key.provider, chatPkFor(accountKey, chatId), messageId, reaction);
+        }),
         saveVote: async (key, chatId, messageId, vote) => write(database, () => {
             const accountKey = accountPk(key);
             messageWrites.saveVote(context, accountKey, key.provider, chatPkFor(accountKey, chatId), messageId, vote);

package/dist/store/sqlite/accounts.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { and, asc, eq, inArray, sql } from "./drizzle/core.js";
 import { pointerPairs } from "./entity-types.js";
-import { accountIdentities, accounts, aliases, botUpdates, chatEventPeople, chatEvents, chatMembers, chats, chunks, fetchLeases, involvements, memberCounts, memberObservationMembers, memberObservations, memberStays, messageRevisions, messages, messageTranscripts, pollVotes, projects, syncCursors, syncRanges, syncs, } from "./schema.js";
+import { accountIdentities, accounts, aliases, botUpdates, chatEventPeople, chatEvents, chatMembers, chats, chunks, fetchLeases, involvements, memberCounts, memberObservationMembers, memberObservations, memberStays, messageReactions, messageRevisions, messages, messageTranscripts, pollVotes, projects, syncCursors, syncRanges, syncs, } from "./schema.js";
 /** An account's row, made on first sight; a name only replaces what was known when there is one. */
 export const accountPk = ({ orm, now }, { provider, account, scope }, name = null) => Number(orm
     .insert(accounts)
@@ -67,6 +67,7 @@ export const purgeAccount = ({ orm, database }, accountKey) => {
     orm.delete(syncs).where(eq(syncs.accountId, accountKey)).run();
     orm.delete(messageTranscripts).where(inArray(messageTranscripts.chatId, chatsOf)).run();
     orm.delete(pollVotes).where(inArray(pollVotes.chatId, chatsOf)).run();
+    orm.delete(messageReactions).where(inArray(messageReactions.chatId, chatsOf)).run();
     orm
         .delete(chatEventPeople)
         .where(inArray(chatEventPeople.chatEventId, orm.select({ id: chatEvents.id }).from(chatEvents).where(inArray(chatEvents.chatId, chatsOf))))

package/dist/store/sqlite/chat-rekey.js

@@ -2,7 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { formatLocator } from "../../domain/locator.js";
 import { purgeChats, revisedBy, stricterPrivacy } from "./chats.js";
 import { pointerPairs } from "./entity-types.js";
-import { tombstone } from "./messages.js";
+import { tombstone, writeDerivedReactions } from "./messages.js";
 import { targetKey } from "./notes.js";
 import { write } from "./transaction.js";
 const chatRow = (context, accountKey, chatId) => context.database.prepare("SELECT * FROM chats WHERE account_id = ? AND external_id = ?").get(accountKey, chatId);
@@ -106,6 +106,9 @@ const absorb = (context, kept, gone) => {
     database
         .prepare("DELETE FROM poll_votes WHERE chat_id = ? AND EXISTS (SELECT 1 FROM poll_votes g WHERE g.chat_id = ? AND g.message_external_id = poll_votes.message_external_id AND g.identity_id = poll_votes.identity_id AND g.voted_at > poll_votes.voted_at)")
         .run(kept, gone);
+    database
+        .prepare("DELETE FROM message_reactions WHERE chat_id = ? AND EXISTS (SELECT 1 FROM message_reactions g WHERE g.chat_id = ? AND g.message_external_id = message_reactions.message_external_id AND g.identity_id = message_reactions.identity_id AND g.reacted_at > message_reactions.reacted_at)")
+        .run(kept, gone);
     // The absorbed copy of an event both chats hold is purged, so the people only it named move first.
     database
         .prepare("INSERT OR IGNORE INTO chat_event_people (chat_event_id, identity_id) SELECT k.id, p.identity_id FROM chat_events g JOIN chat_events k ON k.chat_id = ? AND k.source_id = g.source_id JOIN chat_event_people p ON p.chat_event_id = g.id WHERE g.chat_id = ?")
@@ -113,6 +116,7 @@ const absorb = (context, kept, gone) => {
     foldOpenStays(context, kept, gone);
     for (const table of [
         "poll_votes",
+        "message_reactions",
         "chat_revisions",
         "chat_events",
         "message_transcripts",
@@ -131,6 +135,10 @@ const absorb = (context, kept, gone) => {
     database
         .prepare("DELETE FROM message_transcripts WHERE chat_id = ? AND message_id IN (SELECT id FROM messages WHERE chat_id = ? AND deleted_at IS NOT NULL)")
         .run(kept, kept);
+    for (const { id } of database
+        .prepare("SELECT DISTINCT message_external_id AS id FROM message_reactions WHERE chat_id = ?")
+        .all(kept))
+        writeDerivedReactions(context, kept, id);
     database.prepare("UPDATE chats SET parent_chat_id = ? WHERE parent_chat_id = ?").run(kept, gone);
     pointerMover(context, "chat")(gone, kept);
     purgeChats(context, [gone]);

package/dist/store/sqlite/chats.js

@@ -2,7 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { and, eq, inArray, or, sql } from "./drizzle/core.js";
 import { identityPk } from "./identities.js";
 import { bound } from "./query-filter.js";
-import { chatEventPeople, chatEvents, chatMembers, chats, chunks, fetchLeases, identities, involvements, memberCounts, memberObservationMembers, memberObservations, memberStays, messageRevisions, messages, messageTranscripts, pollVotes, syncRanges, } from "./schema.js";
+import { chatEventPeople, chatEvents, chatMembers, chats, chunks, fetchLeases, identities, involvements, memberCounts, memberObservationMembers, memberObservations, memberStays, messageReactions, messageRevisions, messages, messageTranscripts, pollVotes, syncRanges, } from "./schema.js";
 import { ensureTag } from "./tags.js";
 import { parsed, present, toIso, toMs } from "./values.js";
 /** The chat's own id, when the store key is a chat of this account. */
@@ -262,6 +262,7 @@ export const purgeChats = ({ orm }, pks) => {
         .run();
     orm.delete(messageTranscripts).where(inArray(messageTranscripts.chatId, pks)).run();
     orm.delete(pollVotes).where(inArray(pollVotes.chatId, pks)).run();
+    orm.delete(messageReactions).where(inArray(messageReactions.chatId, pks)).run();
     orm
         .delete(chatEventPeople)
         .where(inArray(chatEventPeople.chatEventId, orm.select({ id: chatEvents.id }).from(chatEvents).where(inArray(chatEvents.chatId, pks))))

package/dist/store/sqlite/manifest.js

@@ -31,6 +31,7 @@ export const MANIFEST = [
     { name: "20261018063952_version-24-message-stars-index", version: 24, minCompatible: 1 },
     { name: "20261019115025_version-25-chat-revisions", version: 25, minCompatible: 1 },
     { name: "20261019115027_version-25-chat-revisions-triggers", version: 25, minCompatible: 1 },
+    { name: "20261021214318_version-26-message-reactions", version: 26, minCompatible: 1 },
 ];
 export const generatedMigrations = (manifest = MANIFEST, generated = GENERATED) => {
     const migrations = [];

package/dist/store/sqlite/meetings.js

@@ -166,14 +166,65 @@ export const saveAttachment = (database, type, parentId, a, now) => upsert(datab
     content_sha256: a.contentSha256,
     extracted_at: a.extractedAt,
 }, now);
+const FILE_SOURCE = "file";
+const SAME_OCCURRENCE_MS = 15 * 60_000;
+/** The account's record of this occurrence under another key: same series, the nearest start within 15 minutes. */
+const sameOccurrence = (database, meeting, seriesKey) => {
+    if (!seriesKey || meeting.startedAt === null)
+        return undefined;
+    const row = database
+        .prepare(`SELECT m.id,m.external_id,m.meeting_series_id,
+       EXISTS (SELECT 1 FROM meeting_transcripts t WHERE t.meeting_id=m.id AND t.source=?) AND
+       NOT EXISTS (SELECT 1 FROM meeting_transcripts t WHERE t.meeting_id=m.id AND t.source!=?) AS from_file
+       FROM meetings m JOIN meeting_series s ON s.id=m.meeting_series_id
+       WHERE m.account_id=? AND s.account_id=? AND s.external_id=? AND m.deleted_at IS NULL
+       AND m.started_at BETWEEN ? AND ? ORDER BY abs(m.started_at-?),m.id LIMIT 1`)
+        .get(FILE_SOURCE, FILE_SOURCE, meeting.accountId, meeting.accountId, seriesKey, meeting.startedAt - SAME_OCCURRENCE_MS, meeting.startedAt + SAME_OCCURRENCE_MS, meeting.startedAt);
+    return row
+        ? {
+            id: row.id,
+            externalId: row.external_id,
+            seriesId: row.meeting_series_id,
+            fromFile: Number(row.from_file) === 1,
+        }
+        : undefined;
+};
+/** A file's copy of an occurrence the provider already gave: its transcript only, and only where there is none. */
+const fillGap = (context, input, meetingId) => {
+    const { database } = context;
+    const held = database
+        .prepare("SELECT 1 FROM meeting_transcripts WHERE meeting_id = ? AND superseded_at IS NULL AND deleted_at IS NULL")
+        .get(meetingId);
+    if (held || !input.transcripts?.length)
+        return meetingId;
+    const participantIds = (input.participants ?? []).map(({ identity, ...p }) => upsert(database, "meeting_participants", {
+        meeting_id: meetingId,
+        identity_id: meetingIdentityPk({ ...context, now: () => input.now }, input.meeting.accountId, identity),
+    }, { display_name: p.displayName, email: p.email, role: p.role, external_id: p.externalId }, input.now));
+    saveTranscripts(database, meetingId, input.transcripts, (position) => (position === null ? null : (participantIds[position] ?? null)), input.now);
+    return meetingId;
+};
 const save = (context, input) => {
     const { database } = context;
     const { meeting: { series: seriesInput, ...meeting }, now, } = input;
     if (!Number.isSafeInteger(meeting.accountId) || meeting.accountId <= 0 || !meeting.externalId)
         throw new Error("Invalid meeting key");
-    const existing = database
+    let existing = database
         .prepare("SELECT id, meeting_series_id FROM meetings WHERE account_id = ? AND external_id = ?")
         .get(meeting.accountId, meeting.externalId);
+    const same = existing ? undefined : sameOccurrence(database, meeting, seriesInput?.externalId);
+    if (same?.fromFile === false && input.fromFile)
+        return fillGap(context, input, Number(same.id));
+    if (same && (same.fromFile || input.fromFile)) {
+        // A provider record takes over a record made from files; two files of one occurrence share the first one's key.
+        if (input.fromFile)
+            meeting.externalId = String(same.externalId);
+        else
+            database
+                .prepare("UPDATE meetings SET external_id = ?, updated_at = ? WHERE id = ?")
+                .run(meeting.externalId, now, Number(same.id));
+        existing = { id: same.id, meeting_series_id: same.seriesId };
+    }
     let seriesId = existing ? int(existing.meeting_series_id) : null;
     if (seriesInput) {
         if (!seriesInput.externalId)
@@ -228,6 +279,10 @@ const save = (context, input) => {
         return id;
     };
     saveTranscripts(database, meetingId, input.transcripts ?? [], participantId, now);
+    if ((input.transcripts ?? []).some((transcript) => transcript.source !== FILE_SOURCE))
+        database
+            .prepare("UPDATE meeting_transcripts SET superseded_at = ?, updated_at = ? WHERE meeting_id = ? AND source = ? AND superseded_at IS NULL")
+            .run(now, now, meetingId, FILE_SOURCE);
     for (const { senderParticipantPosition, ...line } of input.chat ?? []) {
         const values = {
             sent_at: line.sentAt,

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

@@ -1,4 +1,4 @@
-import type { Id, Message, PollVote, Provider, Reactions } from "../../domain/models.js";
+import type { Id, Message, PersonReaction, PollVote, Provider, Reactions } from "../../domain/models.js";
 import type { AccountKey, DeletionScope } from "../types.js";
 import type { StoreContext } from "./open.js";
 export declare const upsertMessage: (context: StoreContext, key: AccountKey, accountKey: number, chatKey: number, message: Message, via: string, seenAt?: number) => void;
@@ -7,11 +7,19 @@ export declare const upsertMessage: (context: StoreContext, key: AccountKey, acc
  * back, and leaves no text — not in the row, the search copy, the edit history, a transcript or a vector.
  */
 export declare const tombstone: (context: StoreContext, pk: number) => number;
-/** Whether the message is held at all. */
-export declare const saveReactions: ({ orm }: StoreContext, chatKey: number, messageId: Id, reactions: Reactions) => boolean;
+/** Whether the message is held at all. Where people's own reactions are held, the totals come from them instead. */
+export declare const saveReactions: (context: StoreContext, chatKey: number, messageId: Id, reactions: Reactions) => boolean;
 /** Answers whether the message is held; a deleted one keeps no star. */
 export declare const saveStar: ({ orm }: StoreContext, chatKey: number, messageId: Id, starred: boolean) => boolean;
 export declare const markDeleted: (context: StoreContext, accountKey: number, messageIds: Id[], chatId: Id | undefined, among?: DeletionScope) => number;
 /** A vote older than the one held for that voter is dropped, and so is any vote in a deleted poll. */
 export declare const saveVote: (context: StoreContext, accountKey: number, provider: Provider, chatKey: number, messageId: Id, { person, answers, votedAt }: PollVote) => void;
 export declare const pollVotes: ({ database }: StoreContext, chatKey: number, messageId: Id) => PollVote[];
+/**
+ * The totals of the people's reactions the store holds for a message, or `undefined` when it holds none: then the
+ * messenger's own totals stand. A taken-back reaction still counts as held, so all of them taken back is zero.
+ */
+export declare const derivedReactions: ({ database }: StoreContext, chatKey: number, messageId: Id) => Reactions | undefined;
+/** A reaction older than the one held for that person is dropped, and so is any reaction to a deleted message. */
+export declare const saveReaction: (context: StoreContext, accountKey: number, provider: Provider, chatKey: number, messageId: Id, { person, own, reaction, reactedAt }: PersonReaction) => void;
+export declare const writeDerivedReactions: (context: StoreContext, chatKey: number, messageId: Id) => void;

package/dist/store/sqlite/messages.js

@@ -174,6 +174,13 @@ export const upsertMessage = (context, key, accountKey, chatKey, message, via, s
         if (revived)
             orm.update(messages).set({ deletedAt: null, text: message.text }).where(eq(messages.id, pk)).run();
     }
+    const derived = derivedReactions(context, chatKey, message.id);
+    if (derived)
+        orm
+            .update(messages)
+            .set({ reactions: JSON.stringify(derived) })
+            .where(eq(messages.id, pk))
+            .run();
     if (message.counterObservations)
         applyCounterObservations(context, pk, message.counterObservations);
     if (message.starred !== undefined)
@@ -237,6 +244,9 @@ export const tombstone = (context, pk) => {
     context.database
         .prepare("DELETE FROM poll_votes WHERE chat_id=? AND message_external_id=?")
         .run(row.chatId, row.externalId);
+    context.database
+        .prepare("DELETE FROM message_reactions WHERE chat_id=? AND message_external_id=?")
+        .run(row.chatId, row.externalId);
     purgeVectorsOf(context, pk);
     orm
         .delete(messageTranscripts)
@@ -244,10 +254,10 @@ export const tombstone = (context, pk) => {
         .run();
     return 1;
 };
-/** Whether the message is held at all. */
-export const saveReactions = ({ orm }, chatKey, messageId, reactions) => orm
+/** Whether the message is held at all. Where people's own reactions are held, the totals come from them instead. */
+export const saveReactions = (context, chatKey, messageId, reactions) => context.orm
     .update(messages)
-    .set({ reactions: JSON.stringify(reactions) })
+    .set({ reactions: JSON.stringify(derivedReactions(context, chatKey, messageId) ?? reactions) })
     .where(and(eq(messages.chatId, chatKey), eq(messages.externalId, messageId), isNull(messages.deletedAt)))
     .returning({ pk: messages.id })
     .all().length > 0;
@@ -326,3 +336,64 @@ export const pollVotes = ({ database }, chatKey, messageId) => database
     answers: JSON.parse(answers),
     votedAt: new Date(votedAt).toISOString(),
 }));
+const reactionStatements = new WeakMap();
+const reactionStatementsOf = (database) => {
+    const held = reactionStatements.get(database);
+    if (held)
+        return held;
+    const statements = {
+        gone: database.prepare("SELECT 1 FROM messages WHERE chat_id=? AND external_id=? AND deleted_at IS NOT NULL"),
+        upsert: database.prepare(`INSERT INTO message_reactions
+         (chat_id, message_external_id, identity_id, own, reaction, reacted_at, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT (chat_id, message_external_id, identity_id) DO UPDATE SET
+         own = excluded.own, reaction = excluded.reaction, reacted_at = excluded.reacted_at,
+         updated_at = excluded.updated_at
+       WHERE excluded.reacted_at >= message_reactions.reacted_at`),
+        held: database.prepare("SELECT reaction, own, reacted_at AS reactedAt FROM message_reactions WHERE chat_id=? AND message_external_id=?"),
+        total: database.prepare("UPDATE messages SET reactions=? WHERE chat_id=? AND external_id=? AND deleted_at IS NULL"),
+    };
+    reactionStatements.set(database, statements);
+    return statements;
+};
+/**
+ * The totals of the people's reactions the store holds for a message, or `undefined` when it holds none: then the
+ * messenger's own totals stand. A taken-back reaction still counts as held, so all of them taken back is zero.
+ */
+export const derivedReactions = ({ database }, chatKey, messageId) => {
+    const rows = reactionStatementsOf(database).held.all(chatKey, messageId);
+    if (rows.length === 0)
+        return undefined;
+    const counts = new Map();
+    let mine = null;
+    for (const { reaction, own, reactedAt } of rows) {
+        if (reaction === null)
+            continue;
+        const held = counts.get(reaction);
+        counts.set(reaction, { count: (held?.count ?? 0) + 1, first: Math.min(held?.first ?? reactedAt, reactedAt) });
+        if (own === 1 && (mine === null || reactedAt > mine.at))
+            mine = { reaction, at: reactedAt };
+    }
+    const sorted = [...counts].sort(([, a], [, b]) => b.count - a.count || a.first - b.first);
+    return {
+        counts: sorted.map(([reaction, { count }]) => ({ reaction, count })),
+        mine: mine?.reaction ?? null,
+        total: sorted.reduce((sum, [, { count }]) => sum + count, 0),
+    };
+};
+/** A reaction older than the one held for that person is dropped, and so is any reaction to a deleted message. */
+export const saveReaction = (context, accountKey, provider, chatKey, messageId, { person, own, reaction, reactedAt }) => {
+    const { database, now } = context;
+    const statements = reactionStatementsOf(database);
+    if (statements.gone.get(chatKey, messageId))
+        return;
+    const reactor = identityPk(context, accountKey, provider, person.id, person.name, person.username ? { username: person.username } : {});
+    const at = toMs(reactedAt) ?? now();
+    statements.upsert.run(chatKey, messageId, reactor, own ? 1 : 0, reaction, at, now(), now());
+    writeDerivedReactions(context, chatKey, messageId);
+};
+export const writeDerivedReactions = (context, chatKey, messageId) => {
+    const derived = derivedReactions(context, chatKey, messageId);
+    if (derived)
+        reactionStatementsOf(context.database).total.run(JSON.stringify(derived), chatKey, messageId);
+};

package/dist/store/sqlite/migrations.generated.js

@@ -554,5 +554,12 @@ export const GENERATED = [
             "CREATE TRIGGER chat_revisions_au AFTER UPDATE OF external_id, title, membership_state, scope, searchable, parent_chat_id ON chats BEGIN\n  INSERT INTO chat_revisions (chat_id, account_id, field, old_value, new_value, source, created_at)\n  SELECT new.id, new.account_id, f.field, f.old_value, f.new_value, s.source,\n    coalesce(s.at, CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))\n  FROM (\n    SELECT 'external_id' AS field, old.external_id AS old_value, new.external_id AS new_value\n    UNION ALL SELECT 'title', old.title, new.title\n    UNION ALL SELECT 'membership_state', old.membership_state, new.membership_state\n    UNION ALL SELECT 'scope', old.scope, new.scope\n    UNION ALL SELECT 'searchable', old.searchable, new.searchable\n    UNION ALL SELECT 'parent_chat_id', old.parent_chat_id, new.parent_chat_id\n  ) f\n  LEFT JOIN chat_revision_source s ON s.id = 1\n  WHERE f.old_value IS NOT f.new_value;\nEND;",
             "CREATE TRIGGER chat_revisions_ad AFTER DELETE ON chats BEGIN\n  DELETE FROM chat_revisions WHERE chat_id = old.id;\nEND;"
         ]
+    },
+    {
+        "name": "20261021214318_version-26-message-reactions",
+        "statements": [
+            "CREATE TABLE `message_reactions` (\n\t`id` integer PRIMARY KEY,\n\t`chat_id` integer NOT NULL,\n\t`message_external_id` text NOT NULL,\n\t`identity_id` integer NOT NULL,\n\t`own` integer NOT NULL,\n\t`reaction` text,\n\t`reacted_at` integer NOT NULL,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL,\n\tCONSTRAINT `fk_message_reactions_chat_id_chats_id_fk` FOREIGN KEY (`chat_id`) REFERENCES `chats`(`id`),\n\tCONSTRAINT `fk_message_reactions_identity_id_identities_id_fk` FOREIGN KEY (`identity_id`) REFERENCES `identities`(`id`),\n\tCONSTRAINT `message_reactions_chat_id_message_external_id_identity_id_unique` UNIQUE(`chat_id`,`message_external_id`,`identity_id`)\n);",
+            "CREATE INDEX `message_reactions_by_identity_id` ON `message_reactions` (`identity_id`);"
+        ]
     }
 ];

package/dist/store/sqlite/open-store.js

@@ -13,6 +13,20 @@ import { assertReadCompatible } from "./read-compatibility.js";
 import { stemsState } from "./stems.js";
 import { fillStems, followDefaultStemmers } from "./stems-fill.js";
 export const BACKFILL_ON_OPEN = 5_000;
+const NOT_WRITABLE = new Set(["EACCES", "EPERM", "EROFS"]);
+const createWritable = (file) => {
+    try {
+        mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+        // SQLite gives its sidecar files the database's permissions.
+        writeFileSync(file, "", { flag: "a", mode: 0o600 });
+    }
+    catch (error) {
+        if (!NOT_WRITABLE.has(error.code ?? ""))
+            throw error;
+        // The errno's own sentence names the path, which holds the owner's home folder.
+        throw new CliError("permission_error", "the message store cannot be written from here; run where it is writable, or set MESSAGING_STORE", { reason: "store.not-writable" });
+    }
+};
 export const openStoreContext = async ({ path, env, now = Date.now, command, readOnly = false, } = {}) => {
     if (typeof readOnly !== "boolean")
         throw new CliError("validation_error", "readOnly must be a boolean");
@@ -22,11 +36,8 @@ export const openStoreContext = async ({ path, env, now = Date.now, command, rea
         if (!statSync(file, { throwIfNoEntry: false })?.isFile())
             throw new CliError("not_found", "The store does not exist as a file; read-only opening does not create it");
     }
-    else {
-        mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
-        // SQLite gives its sidecar files the database's permissions.
-        writeFileSync(file, "", { flag: "a", mode: 0o600 });
-    }
+    else
+        createWritable(file);
     const opened = await openSqlite(file, { readOnly });
     const database = opened.database;
     try {

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

@@ -4478,6 +4478,161 @@ export declare const chatEventPeople: import("drizzle-orm/sqlite-core").SQLiteTa
     };
     dialect: 'sqlite';
 }>;
+/**
+ * Each person's newest reaction to a message, for a messenger that sends one person's change at a time; the store
+ * derives `messages.reactions` from them. Keyed by chat and external id: a reaction can arrive before its message.
+ */
+export declare const messageReactions: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "message_reactions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        chatId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        messageExternalId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        identityId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        own: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        reaction: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        reactedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "message_reactions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: 'sqlite';
+}>;
 /** One read of a chat's member list. Retention reads presence at a checkpoint from these, not from stays. */
 export declare const memberObservations: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "member_observations";

package/dist/store/sqlite/schema.js

@@ -511,6 +511,28 @@ export const chatEventPeople = sqliteTable("chat_event_people", {
     primaryKey({ columns: [table.chatEventId, table.identityId] }),
     index("chat_event_people_by_identity_id").on(table.identityId),
 ]);
+/**
+ * Each person's newest reaction to a message, for a messenger that sends one person's change at a time; the store
+ * derives `messages.reactions` from them. Keyed by chat and external id: a reaction can arrive before its message.
+ */
+export const messageReactions = sqliteTable("message_reactions", {
+    id: integer("id").primaryKey(),
+    chatId: integer("chat_id")
+        .notNull()
+        .references(() => chats.id),
+    messageExternalId: text("message_external_id").notNull(),
+    identityId: integer("identity_id")
+        .notNull()
+        .references(() => identities.id),
+    own: integer("own").notNull(),
+    reaction: text("reaction"),
+    reactedAt: integer("reacted_at").notNull(),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [
+    unique().on(table.chatId, table.messageExternalId, table.identityId),
+    index("message_reactions_by_identity_id").on(table.identityId),
+]);
 /** One read of a chat's member list. Retention reads presence at a checkpoint from these, not from stays. */
 export const memberObservations = sqliteTable("member_observations", {
     id: integer("id").primaryKey(),

package/package.json

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