@wirecat/cli-core 0.356.0 → 0.358.0

package/CHANGELOG.md

@@ -5,7 +5,24 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.358.0 — 19.10.2026
+
+### Added
+
+- **Meeting transcripts in bounded context reads:** `ContextSource.kind` accepts `meeting`; the native
+  reader returns current transcript cue references with `timeKind: "meeting-start"`. Account/time scope,
+  cursor validation, read-only snapshots and pre-hydration byte limits apply. Deleted/superseded and
+  queued cues are excluded; missing indexes and unknown archive coverage remain explicit. Hosts must
+  opt in to meeting sources; the reader does not fetch recordings, fill indexes or infer project links.
+
+## 0.357.0 — 19.10.2026
+
+### Added
+
+- **An adapter can say "member again" without clearing other states.** `ChatUpdate.membershipState` (in `saveChats`
+  and a pushed `HistoryBatch.chats`) now also takes `"member"`: it takes off a "left" mark, as `rejoinChats` does,
+  and keeps any other stored state, such as "archived"; a new chat stores none. It is never stored or read back.
+  `null` still clears every state. Send `"member"` when the owner is added back to a group. Additive.
 
 ## 0.356.0 — 19.10.2026
 

package/dist/cli/meeting-communications.d.ts

@@ -37,7 +37,7 @@ export declare const mapPreparationCommunications: ({ items, ...section }: Meeti
         title: string | null;
         url: string | null;
         text: string;
-        timeKind: "sent" | "source-modified" | "stored-update";
+        timeKind: "sent" | "source-modified" | "stored-update" | "meeting-start";
         revision: number | null;
         selectionId: string;
         textTruncated: boolean;

package/dist/context/evidence-response.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { formatLocator, parseLocator } from "../domain/locator.js";
+import { formatMeetingReference, parseMeetingReference } from "../meetings/index.js";
 import { contextEvidenceRequest, contextSource, } from "./evidence.js";
 export const contextSourceKey = (source) => JSON.stringify([source.kind, source.accountId, source.provider, source.account]);
 export const validateContextEvidencePage = (page, request) => {
@@ -49,9 +50,9 @@ export const validateContextEvidencePage = (page, request) => {
                 fail();
             if (item.revision !== null && (!Number.isSafeInteger(item.revision) || item.revision < 1))
                 fail();
-            if (!["source-modified", "stored-update", "sent"].includes(item.timeKind) ||
-                (source.kind !== "document" && item.timeKind !== "sent") ||
-                (source.kind === "document" && item.timeKind === "sent"))
+            if (source.kind === "document"
+                ? !["source-modified", "stored-update"].includes(item.timeKind)
+                : item.timeKind !== (source.kind === "meeting" ? "meeting-start" : "sent"))
                 fail();
             const text = [item.text, item.title, item.url, item.provider, item.account, item.timeKind];
             if (text.some((value) => value !== null && typeof value !== "string"))
@@ -61,6 +62,15 @@ export const validateContextEvidencePage = (page, request) => {
                 if (!Number.isSafeInteger(id) || id < 1 || item.ref !== `document:${id}`)
                     fail();
             }
+            else if (source.kind === "meeting") {
+                const reference = parseMeetingReference(item.ref);
+                if (reference.accountId !== source.accountId ||
+                    reference.transcriptId === undefined ||
+                    reference.cuePosition === undefined ||
+                    formatMeetingReference(reference) !== item.ref)
+                    fail();
+                text.push(item.ref);
+            }
             else {
                 const locator = parseLocator(item.ref);
                 if (locator.provider !== source.provider ||

package/dist/context/evidence.d.ts

@@ -1,4 +1,4 @@
-export declare const CONTEXT_SOURCE_KINDS: readonly ["message", "mail", "document"];
+export declare const CONTEXT_SOURCE_KINDS: readonly ["message", "mail", "document", "meeting"];
 export interface ContextSource {
     kind: (typeof CONTEXT_SOURCE_KINDS)[number];
     accountId: number;
@@ -27,7 +27,7 @@ export interface ContextEvidenceItem {
     url: string | null;
     text: string;
     at: number;
-    timeKind: "sent" | "source-modified" | "stored-update";
+    timeKind: "sent" | "source-modified" | "stored-update" | "meeting-start";
     updatedAt: number;
     revision: number | null;
 }

package/dist/context/evidence.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { CliError } from "@wirecat/cli-base";
-export const CONTEXT_SOURCE_KINDS = ["message", "mail", "document"];
+export const CONTEXT_SOURCE_KINDS = ["message", "mail", "document", "meeting"];
 export const contextCursorScope = (request) => createHash("sha256")
     .update(JSON.stringify([
     "context-evidence-v1",

package/dist/domain/models.d.ts

@@ -49,10 +49,11 @@ export interface Chat {
 /**
  * A chat as an adapter saves it. A `title`, `unreadCount`, `lastMessageAt`, `participantsCount` or `membershipState`
  * left out keeps the stored value; `null` stores none. So a push that knows only some of them, such as a notice that
- * a group left its community, leaves the rest out.
+ * a group left its community, leaves the rest out. `membershipState: "member"` says the owner is in the chat again: it
+ * takes off a "left" mark and keeps any other state, such as "archived". It is never stored.
  */
 export type ChatUpdate = Omit<Chat, KeptFields | "membershipState"> & Partial<Pick<Chat, KeptFields>> & {
-    membershipState?: MembershipState | null;
+    membershipState?: MembershipState | "member" | null;
 };
 type KeptFields = "title" | "unreadCount" | "lastMessageAt" | "participantsCount";
 /** A group's switches; `null` where the messenger does not say, or has no such switch. */

package/dist/store/sqlite/chats.js

@@ -104,7 +104,7 @@ export const upsertChat = (context, accountKey, chat) => {
         lastMessageAt: toMs(chat.lastMessageAt),
         participantsCount: chat.participantsCount ?? null,
         metadata: mergedMetadata(stored?.metadata ?? null, chat.providerMetadata),
-        membershipState: chat.membershipState ?? null,
+        membershipState: chat.membershipState === "member" ? null : (chat.membershipState ?? null),
         createdAt: now(),
         updatedAt: now(),
     })
@@ -119,12 +119,19 @@ export const upsertChat = (context, accountKey, chat) => {
             ...(chat.lastMessageAt === undefined ? {} : { lastMessageAt: sql `excluded.last_message_at` }),
             ...(chat.participantsCount === undefined ? {} : { participantsCount: sql `excluded.participants_count` }),
             metadata: sql `excluded.metadata`,
-            ...(chat.membershipState === undefined ? {} : { membershipState: sql `excluded.membership_state` }),
+            ...membershipSet(chat.membershipState),
             updatedAt: sql `excluded.updated_at`,
         },
     })
         .run();
 };
+const membershipSet = (state) => {
+    if (state === undefined)
+        return {};
+    if (state === "member")
+        return { membershipState: sql `nullif(${chats.membershipState}, 'left')` };
+    return { membershipState: sql `excluded.membership_state` };
+};
 const mergedMetadata = (stored, incoming) => {
     if (incoming === undefined)
         return stored;

package/dist/store/sqlite/context-evidence.js

@@ -3,6 +3,7 @@ import { contextCursorScope, contextEvidenceRequest, } from "../../context/evide
 import { formatLocator } from "../../domain/locator.js";
 import { NORMALIZER_VERSION, normalize } from "../normalize.js";
 import { contextDocumentTime, contextDocumentTimeKind, contextDocumentUrl } from "./context-document-source.js";
+import { readMeetingContextEvidence } from "./context-meeting-source.js";
 import { drainEmailIndex } from "./email-index.js";
 import { drainNoteIndex } from "./note-index.js";
 import { read } from "./transaction.js";
@@ -52,10 +53,12 @@ export const contextEvidenceOver = ({ database }) => ({
     async read(original) {
         const request = contextEvidenceRequest(original);
         const { source, words, after, before, limit, maxReadBytes, cursor, signal } = request;
+        if (source.kind === "meeting")
+            return readMeetingContextEvidence(database, request);
+        const corpus = corpora[source.kind];
         const scope = contextCursorScope({ source, query: request.query, after, before });
         signal?.throwIfAborted();
         return read(database, () => {
-            const corpus = corpora[source.kind];
             const coverage = {
                 available: false,
                 index: "unknown",

package/dist/store/sqlite/context-meeting-source.d.ts

@@ -0,0 +1,6 @@
+import { type ContextEvidencePage, type contextEvidenceRequest } from "../../context/evidence.js";
+import type { CacheDatabase } from "../driver.js";
+type Request = ReturnType<typeof contextEvidenceRequest>;
+/** Transcript cues keep their retained revision reference; a meeting title alone is not a transcript match. */
+export declare const readMeetingContextEvidence: (database: CacheDatabase, request: Request) => ContextEvidencePage;
+export {};

package/dist/store/sqlite/context-meeting-source.js

@@ -0,0 +1,97 @@
+import { CliError } from "@wirecat/cli-base";
+import { contextCursorScope } from "../../context/evidence.js";
+import { normalize } from "../normalize.js";
+import { read } from "./transaction.js";
+/** Transcript cues keep their retained revision reference; a meeting title alone is not a transcript match. */
+export const readMeetingContextEvidence = (database, request) => {
+    const { source, words, after, before, limit, maxReadBytes, cursor, signal } = request;
+    signal?.throwIfAborted();
+    return read(database, () => {
+        const coverage = {
+            available: false,
+            index: "unknown",
+            hasMore: false,
+            hasUndated: false,
+            completeness: "unknown",
+            matching: "literal-words",
+            consistency: "snapshot-per-page",
+        };
+        const empty = () => ({ source, items: [], next: null, readBytes: 0, coverage });
+        const scope = [source.accountId, source.provider, source.account];
+        if (!database.prepare("SELECT 1 FROM accounts WHERE id=? AND provider=? AND external_id=?").get(...scope))
+            return empty();
+        coverage.available = true;
+        const base = `FROM meeting_transcript_rows r
+      JOIN meeting_transcripts t ON t.id=r.meeting_transcript_id
+      JOIN meetings m ON m.id=t.meeting_id
+      JOIN accounts a ON a.id=m.account_id
+      WHERE m.account_id=? AND a.provider=? AND a.external_id=?
+      AND m.deleted_at IS NULL AND t.deleted_at IS NULL AND t.superseded_at IS NULL`;
+        coverage.hasUndated = Boolean(database.prepare(`SELECT 1 ${base} AND m.started_at IS NULL LIMIT 1`).get(...scope));
+        if (!database.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='meeting_words'").get()) {
+            coverage.index = "missing";
+            return empty();
+        }
+        coverage.index = database
+            .prepare(`SELECT 1 ${base} AND m.started_at>=? AND m.started_at<?
+        AND EXISTS(SELECT 1 FROM meeting_index_pending p
+        WHERE p.indexable_type='meeting_transcript_row' AND p.id=r.id) LIMIT 1`)
+            .get(...scope, after, before)
+            ? "pending"
+            : "ready";
+        const reference = "'meeting:'||m.account_id||'/'||m.id||'/'||t.id||'/'||r.position";
+        const selection = `SELECT r.id,m.title,r.text,a.provider,a.external_id AS account,
+      m.started_at AS at,max(m.updated_at,t.updated_at,r.created_at) AS updated_at,
+      ${reference} AS ref ${base} AND m.started_at>=? AND m.started_at<?
+      AND (r.id*4+1) IN (SELECT rowid FROM meeting_words WHERE meeting_words MATCH ?)
+      AND NOT EXISTS(SELECT 1 FROM meeting_index_pending p
+        WHERE p.indexable_type='meeting_transcript_row' AND p.id=r.id)
+      ${cursor ? "AND (m.started_at<? OR (m.started_at=? AND r.id<?))" : ""}
+      ORDER BY m.started_at DESC,r.id DESC LIMIT ?`;
+        const params = [
+            ...scope,
+            after,
+            before,
+            words.map((word) => `normalized_text:"${normalize(word)}"`).join(" AND "),
+        ];
+        if (cursor)
+            params.push(cursor.at, cursor.at, cursor.id);
+        params.push(limit + 1);
+        const probe = database
+            .prepare(`SELECT coalesce(sum(length(CAST(coalesce(title,'') AS BLOB))+
+        length(CAST(text AS BLOB))+length(CAST(provider AS BLOB))+
+        length(CAST(account AS BLOB))+length(CAST(ref AS BLOB))+length('meeting-start')),0) AS bytes FROM (${selection})`)
+            .get(...params);
+        const readBytes = Number(probe?.bytes);
+        if (!Number.isSafeInteger(readBytes) || readBytes < 0 || readBytes > maxReadBytes)
+            throw new CliError("validation_error", "meeting context evidence exceeds maxReadBytes before hydration", {
+                reason: "context.read-budget",
+            });
+        signal?.throwIfAborted();
+        const rows = database.prepare(selection).all(...params);
+        signal?.throwIfAborted();
+        coverage.hasMore = rows.length > limit;
+        const selected = rows.slice(0, limit);
+        const last = selected.at(-1);
+        return {
+            source,
+            readBytes,
+            coverage,
+            next: coverage.hasMore && last
+                ? { at: Number(last.at), id: Number(last.id), scope: contextCursorScope(request) }
+                : null,
+            items: selected.map((row) => ({
+                ref: String(row.ref),
+                provider: String(row.provider),
+                account: String(row.account),
+                title: row.title === null ? null : String(row.title),
+                url: null,
+                text: String(row.text),
+                at: Number(row.at),
+                timeKind: "meeting-start",
+                updatedAt: Number(row.updated_at),
+                revision: null,
+            })),
+        };
+    });
+};

package/package.json

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