@wirecat/cli-core 0.388.0 → 0.390.0

package/CHANGELOG.md

@@ -5,7 +5,20 @@ 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.389.0 — 22.10.2026
+
+### Added
+
+- **`readMeetingStats`: talk time per speaker and meetings per week.** Over the meetings search would read, with the
+  same filters: per speaker (a linked person, else the identity, else the transcript's name) lines, words, talk time,
+  meetings and share of talk; per week (Monday in a chosen zone) meetings and talk time. One transcript per meeting,
+  so a local transcript beside the provider's does not count twice. `meetings.meetingStats` on the store and
+  `aggregateMeetingStats` for rows a host already has.
+
+### Fixed
+
+- **A recorded one-shot command's `meta.run_id` names the run it kept**, so `runs show <run_id>` finds it. It named
+  the process's own run, which is never kept.
 
 ## 0.388.0 — 22.10.2026
 

package/dist/cli/context.js

@@ -79,6 +79,7 @@ export const baseContext = (command, resolveSettings) => {
                 keepFailed: settings.keepFailedRuns,
                 trace: settings.trace,
                 keepDays: settings.keepRunsForDays,
+                processRun: !environment.agent,
                 format,
                 streams,
                 env,

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -2,9 +2,9 @@ import { Command } from "commander";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
     path: string;
     exists: boolean;
-    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/program.js

@@ -10,6 +10,7 @@ import { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 import { failureContext } from "../errors/reasons.js";
 import { envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 import { recorded, wasSettled } from "../runs/recording.js";
+import { processRun, useAsProcessRun } from "../runs/scope.js";
 import { keyForCommand } from "../sends/permissions.js";
 import { logParsedArgv, logVersion } from "./argv-log.js";
 import { commandPathOf } from "./command-contract.js";
@@ -104,6 +105,15 @@ const RELAY_MARGIN_MS = 10_000;
  * message: it tells a script nothing it can branch on, and exits 1 for every kind of failure alike.
  */
 export const run = async (argv, definition, options = {}) => {
+    const outer = processRun();
+    try {
+        return await runOnce(argv, definition, options);
+    }
+    finally {
+        useAsProcessRun(outer);
+    }
+};
+const runOnce = async (argv, definition, options) => {
     const streams = options.streams ?? processStreams;
     if (!options.streams)
         quietBrokenPipes();

package/dist/meetings/index.d.ts

@@ -40,6 +40,7 @@ export { createMeetingSeriesInventoryReader } from "./series-inventory.js";
 export type { MeetingSeriesCandidate, MeetingSeriesInventoryPage, MeetingSeriesInventoryPort, MeetingSeriesInventoryRead, MeetingSeriesInventoryRequest, MeetingSeriesInventoryResult, } from "./series-inventory-types.js";
 export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validation.js";
 export type { MeetingSource, SourceParticipant } from "./source.js";
+export { aggregateMeetingStats, type MeetingSpeakerStats, type MeetingStats, type MeetingStatsInput, type MeetingStatsRow, type MeetingStatsSelection, type MeetingStatsStore, type MeetingWeekStats, } from "./stats.js";
 export type { ChatInput, ContractCase, EventCandidateFilter, IdentityInput, MeetingDetails, MeetingFilter, MeetingHitSource, MeetingInput, MeetingSave, MeetingStore, NewRecord, ParticipantInput, SearchHit, TranscriptInput, TranscriptRowInput, } from "./store.js";
 export type { MeetingTranscriptReceiptStore, MeetingTranscriptStore, TranscriptAppend, TranscriptAppendReceipt, UnlinkedTranscriptInput, } from "./transcript-store.js";
 export { parseTranscriptText, TranscriptTextError, type TranscriptTextHeader } from "./transcript-text.js";

package/dist/meetings/index.js

@@ -28,6 +28,7 @@ export { validateMeetingHitSearch } from "./search-validation.js";
 export { validateMeetingSeriesHistory, } from "./series-history.js";
 export { createMeetingSeriesInventoryReader } from "./series-inventory.js";
 export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validation.js";
+export { aggregateMeetingStats, } from "./stats.js";
 export { parseTranscriptText, TranscriptTextError } from "./transcript-text.js";
 export { transcribeMeeting, } from "./transcription.js";
 export { createUpcomingMeetingReader } from "./upcoming.js";

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

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

package/dist/meetings/stats.d.ts

@@ -0,0 +1,59 @@
+import type { MeetingSearchOptions } from "./search-store.js";
+/** The meetings the numbers cover: the same filters as meeting search. */
+export type MeetingStatsSelection = Pick<MeetingSearchOptions, "accountId" | "meetingId" | "eventId" | "meetingSeriesId" | "since" | "until" | "participantIdentityId" | "personId" | "projectId" | "tagId" | "signal">;
+export interface MeetingStatsInput extends MeetingStatsSelection {
+    /** The zone a week starts on Monday in; UTC when not given. */
+    timeZone?: string;
+    /** Most transcript lines to read (default 500000); more is an error, never a silent cut. */
+    maxRows?: number;
+}
+/** One transcript line as the numbers need it: who said it, when, for how long, in how many words. */
+export interface MeetingStatsRow {
+    meetingId: number;
+    startedAt: number | null;
+    startMs: number;
+    endMs: number;
+    words: number;
+    personId: number | null;
+    personName: string | null;
+    identityId: number | null;
+    identityName: string | null;
+    speakerName: string | null;
+}
+export interface MeetingSpeakerStats {
+    /** `person:<id>`, `identity:<id>`, `name:<lowercased name>` or `unknown`. */
+    key: string;
+    name: string | null;
+    personId: number | null;
+    identityId: number | null;
+    meetings: number;
+    lines: number;
+    words: number;
+    talkMs: number;
+    /** This speaker's part of all talk time in the selection, 0–1. */
+    share: number;
+}
+export interface MeetingWeekStats {
+    /** The Monday the week starts on, in the chosen zone: `2026-10-19`. */
+    weekStart: string;
+    meetings: number;
+    talkMs: number;
+}
+export interface MeetingStats {
+    timeZone: string;
+    meetings: number;
+    lines: number;
+    words: number;
+    talkMs: number;
+    speakers: MeetingSpeakerStats[];
+    weeks: MeetingWeekStats[];
+}
+export interface MeetingStatsStore {
+    meetingStats(input: MeetingStatsInput): Promise<MeetingStats>;
+}
+/**
+ * Talk time, lines and words per speaker, and meetings and talk time per week. A speaker is a linked person when the
+ * line's participant has one, else the participant's identity, else the name the transcript gives; lines with none
+ * are `unknown`. Talk time is each line's end less its start, so overlapping speech counts for everyone speaking.
+ */
+export declare const aggregateMeetingStats: (rows: readonly MeetingStatsRow[], timeZone?: string) => MeetingStats;

package/dist/meetings/stats.js

@@ -0,0 +1,95 @@
+import { CliError } from "@wirecat/cli-base";
+const zoneOf = (timeZone) => {
+    const zone = timeZone ?? "UTC";
+    try {
+        new Intl.DateTimeFormat("en", { timeZone: zone });
+    }
+    catch {
+        throw new CliError("validation_error", "expected an IANA time zone such as Europe/Madrid");
+    }
+    return zone;
+};
+const DAYS = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
+const weekStart = (at, format) => {
+    const parts = Object.fromEntries(format.formatToParts(new Date(at)).map((part) => [part.type, part.value]));
+    const day = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day));
+    return new Date(day - DAYS.indexOf(parts.weekday ?? "Mon") * 86_400_000).toISOString().slice(0, 10);
+};
+/** Lines with no speaker at all; a constant, since a `key: "…"` literal reads as a permission key to the key test. */
+const UNKNOWN_SPEAKER = "unknown";
+const speakerOf = (row) => row.personId !== null
+    ? { key: `person:${row.personId}`, name: row.personName ?? row.identityName ?? row.speakerName }
+    : row.identityId !== null
+        ? { key: `identity:${row.identityId}`, name: row.identityName ?? row.speakerName }
+        : row.speakerName?.trim()
+            ? { key: `name:${row.speakerName.trim().toLowerCase()}`, name: row.speakerName.trim() }
+            : { key: UNKNOWN_SPEAKER, name: null };
+/**
+ * Talk time, lines and words per speaker, and meetings and talk time per week. A speaker is a linked person when the
+ * line's participant has one, else the participant's identity, else the name the transcript gives; lines with none
+ * are `unknown`. Talk time is each line's end less its start, so overlapping speech counts for everyone speaking.
+ */
+export const aggregateMeetingStats = (rows, timeZone) => {
+    const zone = zoneOf(timeZone);
+    const format = new Intl.DateTimeFormat("en-US", {
+        timeZone: zone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        weekday: "short",
+    });
+    const speakers = new Map();
+    const weeks = new Map();
+    const meetings = new Set();
+    let lines = 0;
+    let words = 0;
+    let talkMs = 0;
+    for (const row of rows) {
+        const talk = Math.max(0, row.endMs - row.startMs);
+        meetings.add(row.meetingId);
+        lines += 1;
+        words += row.words;
+        talkMs += talk;
+        const who = speakerOf(row);
+        const held = speakers.get(who.key) ?? {
+            key: who.key,
+            name: who.name ?? null,
+            personId: row.personId,
+            identityId: row.personId === null ? row.identityId : null,
+            meetings: 0,
+            lines: 0,
+            words: 0,
+            talkMs: 0,
+            share: 0,
+            seen: new Set(),
+        };
+        held.seen.add(row.meetingId);
+        held.lines += 1;
+        held.words += row.words;
+        held.talkMs += talk;
+        speakers.set(who.key, held);
+        if (row.startedAt !== null) {
+            const week = weeks.get(weekStart(row.startedAt, format)) ?? { meetings: new Set(), talkMs: 0 };
+            week.meetings.add(row.meetingId);
+            week.talkMs += talk;
+            weeks.set(weekStart(row.startedAt, format), week);
+        }
+    }
+    return {
+        timeZone: zone,
+        meetings: meetings.size,
+        lines,
+        words,
+        talkMs,
+        speakers: [...speakers.values()]
+            .map(({ seen, ...speaker }) => ({
+            ...speaker,
+            meetings: seen.size,
+            share: talkMs === 0 ? 0 : Math.round((speaker.talkMs / talkMs) * 1000) / 1000,
+        }))
+            .sort((a, b) => b.talkMs - a.talkMs || a.key.localeCompare(b.key)),
+        weeks: [...weeks.entries()]
+            .map(([start, week]) => ({ weekStart: start, meetings: week.meetings.size, talkMs: week.talkMs }))
+            .sort((a, b) => a.weekStart.localeCompare(b.weekStart)),
+    };
+};

package/dist/runs/recording.d.ts

@@ -19,6 +19,11 @@ export interface RecordingOptions {
     now?: () => Date;
     /** The caller's trace; otherwise the enclosing run's, otherwise `TRACEPARENT` from `env`. */
     traceId?: string;
+    /**
+     * A one-shot command prints its answer after the run ends, outside `inRun`: naming the run as the process's lets
+     * that answer's `meta.run_id` name the run `runs show` finds. Never in a server, where runs overlap.
+     */
+    processRun?: boolean;
 }
 /**
  * Runs one command with the diagnostics turned on, and **finalizes on every path**.

package/dist/runs/recording.js

@@ -4,7 +4,7 @@ import { providerErrorKey, renderEvent } from "./events.js";
 import { DIAGNOSTIC_LOG_EVENTS } from "./log-events.js";
 import { logAttributes } from "./log-keys.js";
 import { newRunId, runsDirFor, startRun } from "./run.js";
-import { enclosingTraceId, inRun, traceOf } from "./scope.js";
+import { enclosingTraceId, inRun, traceOf, useAsProcessRun } from "./scope.js";
 /**
  * Runs one command with the diagnostics turned on, and **finalizes on every path**.
  *
@@ -15,13 +15,16 @@ import { enclosingTraceId, inRun, traceOf } from "./scope.js";
 export const recorded = async (options, body) => {
     const recording = startRecording(options);
     try {
-        const answer = await inRun({
+        const scope = {
             runId: recording.runId,
             command: options.command,
             startedAt: Date.now(),
             profile: options.profile,
             ...(recording.traceId ? { traceId: recording.traceId } : {}),
-        }, () => body(recording.events));
+        };
+        if (options.processRun)
+            useAsProcessRun(scope);
+        const answer = await inRun(scope, () => body(recording.events));
         await recording.succeed(answer);
         return answer;
     }

package/dist/runs/scope.d.ts

@@ -23,7 +23,9 @@ export declare const typedCommand: (tool: string, words: string, profile?: strin
  * For a one-shot command whose action runs outside `inRun` — max's `max bot`, recorded from commander's hooks, which
  * cannot wrap the action — so its answers' `meta.run_id` names the run `runs show` finds. Never in a server.
  */
-export declare const useAsProcessRun: (scope: RunScope) => void;
+export declare const useAsProcessRun: (scope: RunScope | undefined) => void;
+/** The run `useAsProcessRun` named, if any: a command run in-process puts it back when it ends. */
+export declare const processRun: () => RunScope | undefined;
 /** The trace of the run this one is opened inside — an MCP call's command keeps its caller's trace. */
 export declare const enclosingTraceId: () => string | undefined;
 /**

package/dist/runs/scope.js

@@ -33,6 +33,8 @@ export const typedCommand = (tool, words, profile = currentRun().profile) => [to
 export const useAsProcessRun = (scope) => {
     processScope = scope;
 };
+/** The run `useAsProcessRun` named, if any: a command run in-process puts it back when it ends. */
+export const processRun = () => processScope;
 /** The trace of the run this one is opened inside — an MCP call's command keeps its caller's trace. */
 export const enclosingTraceId = () => scopes.getStore()?.traceId;
 /**

package/dist/services/index.d.ts

@@ -67,6 +67,7 @@ export { readMail } from "./mail-search.js";
 export { type MeetingHitSearchRequest, refreshMeetingIndex, searchMeetingHits } from "./meeting-hit-search.js";
 export { createMeetingProjectCandidateReader } from "./meeting-project-candidates.js";
 export { readMeetingProjectDiscovery } from "./meeting-project-discovery.js";
+export { type MeetingStatsRequest, readMeetingStats } from "./meeting-stats.js";
 export { chatIdIn, storedChatId } from "./message-resolution.js";
 export type { AroundWindow, FoundMessage, ListWindow, MessagesService, MessageTarget, Pinned, Reacted, SearchFound, SearchQuery, SendRequest, Starred, } from "./messages.js";
 export { DELETE_AT_ONCE, messagesService } from "./messages.js";

package/dist/services/index.js

@@ -48,6 +48,7 @@ export { readMail } from "./mail-search.js";
 export { refreshMeetingIndex, searchMeetingHits } from "./meeting-hit-search.js";
 export { createMeetingProjectCandidateReader } from "./meeting-project-candidates.js";
 export { readMeetingProjectDiscovery } from "./meeting-project-discovery.js";
+export { readMeetingStats } from "./meeting-stats.js";
 export { chatIdIn, storedChatId } from "./message-resolution.js";
 export { DELETE_AT_ONCE, messagesService } from "./messages.js";
 export { searchStore } from "./messages-archive-search.js";

package/dist/services/meeting-stats.d.ts

@@ -0,0 +1,13 @@
+import type { MeetingHitSearchRequest, MeetingStats } from "../meetings/index.js";
+import type { MessageStore } from "../store/store.js";
+import { resolveMeetingSelection } from "./meeting-hit-search.js";
+export type MeetingStatsRequest = Omit<MeetingHitSearchRequest, "limit" | "after" | "maxReadBytes"> & {
+    timeZone?: string;
+    maxRows?: number;
+};
+/** Talk time and lines per speaker and meetings per week over the meetings search would read, names resolved alike. */
+export declare const readMeetingStats: (store: Pick<MessageStore, "meetings"> & {
+    knowledge?: MessageStore["knowledge"];
+}, request: MeetingStatsRequest) => Promise<MeetingStats & {
+    selection: Awaited<ReturnType<typeof resolveMeetingSelection>>["selection"];
+}>;

package/dist/services/meeting-stats.js

@@ -0,0 +1,12 @@
+import { resolveMeetingSelection } from "./meeting-hit-search.js";
+/** Talk time and lines per speaker and meetings per week over the meetings search would read, names resolved alike. */
+export const readMeetingStats = async (store, request) => {
+    const { timeZone, maxRows, ...selecting } = request;
+    const { input, selection } = await resolveMeetingSelection(store, selecting);
+    const stats = await store.meetings.meetingStats({
+        ...input,
+        ...(timeZone === undefined ? {} : { timeZone }),
+        ...(maxRows === undefined ? {} : { maxRows }),
+    });
+    return { ...stats, selection };
+};

package/dist/store/sqlite/meeting-stats.d.ts

@@ -0,0 +1,7 @@
+import { type MeetingStatsStore } from "../../meetings/index.js";
+import type { StoreContext } from "./open.js";
+/**
+ * One transcript per meeting — its earliest current one — so a local transcript beside the provider's does not count
+ * the talk twice. Words are counted from spaces in SQL, so no transcript text leaves the database.
+ */
+export declare const meetingStatsOver: ({ database }: StoreContext) => MeetingStatsStore;

package/dist/store/sqlite/meeting-stats.js

@@ -0,0 +1,55 @@
+import { CliError } from "@wirecat/cli-base";
+import { aggregateMeetingStats } from "../../meetings/index.js";
+import { checkMeetingCancelled } from "./meeting-operation.js";
+import { positiveReadInteger } from "./meeting-reads.js";
+import { meetingSelectionSql } from "./meeting-selection.js";
+import { read } from "./transaction.js";
+const MOST_ROWS = 500_000;
+/**
+ * One transcript per meeting — its earliest current one — so a local transcript beside the provider's does not count
+ * the talk twice. Words are counted from spaces in SQL, so no transcript text leaves the database.
+ */
+export const meetingStatsOver = ({ database }) => ({
+    async meetingStats(input) {
+        checkMeetingCancelled(input.signal);
+        positiveReadInteger(input.accountId, "accountId");
+        const maxRows = input.maxRows ?? MOST_ROWS;
+        if (!Number.isSafeInteger(maxRows) || maxRows < 1 || maxRows > MOST_ROWS)
+            throw new CliError("validation_error", `meeting stats read 1 through ${MOST_ROWS} transcript lines`);
+        return read(database, () => {
+            const { clauses, params } = meetingSelectionSql(input);
+            const sql = `WITH selected AS (SELECT m.id, m.started_at FROM meetings m WHERE ${clauses.join(" AND ")}),
+        chosen AS (SELECT min(t.id) AS id, t.meeting_id FROM meeting_transcripts t JOIN selected s ON s.id = t.meeting_id
+          WHERE t.deleted_at IS NULL AND t.superseded_at IS NULL GROUP BY t.meeting_id)
+        SELECT c.meeting_id, s.started_at, r.start_ms, r.end_ms,
+          length(trim(r.text)) - length(replace(trim(r.text), ' ', '')) + (length(trim(r.text)) > 0) AS words,
+          l.person_id, person.name AS person_name, p.identity_id, i.name AS identity_name,
+          coalesce(r.speaker_name, p.display_name) AS speaker_name
+        FROM chosen c JOIN selected s ON s.id = c.meeting_id
+        JOIN meeting_transcript_rows r ON r.meeting_transcript_id = c.id
+        LEFT JOIN meeting_participants p ON p.id = r.speaker_participant_id
+        LEFT JOIN identities i ON i.id = p.identity_id
+        LEFT JOIN identity_links l ON l.identity_id = p.identity_id
+        LEFT JOIN persons person ON person.id = l.person_id
+        LIMIT ?`;
+            const rows = database.prepare(sql).all(...params, maxRows + 1);
+            if (rows.length > maxRows)
+                throw new CliError("validation_error", `the selection has more than ${maxRows} transcript lines; narrow it`);
+            checkMeetingCancelled(input.signal);
+            const nullable = (value) => (value === null || value === undefined ? null : Number(value));
+            const text = (value) => (value === null || value === undefined ? null : String(value));
+            return aggregateMeetingStats(rows.map((row) => ({
+                meetingId: Number(row.meeting_id),
+                startedAt: nullable(row.started_at),
+                startMs: Number(row.start_ms),
+                endMs: Number(row.end_ms),
+                words: Number(row.words),
+                personId: nullable(row.person_id),
+                personName: text(row.person_name),
+                identityId: nullable(row.identity_id),
+                identityName: text(row.identity_name),
+                speakerName: text(row.speaker_name),
+            })), input.timeZone);
+        });
+    },
+});

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

@@ -1,4 +1,4 @@
-import type { Attachment, MeetingContextStore, MeetingParticipantSearchStore, MeetingPreparationContextStore, MeetingPreparationKnowledgeStore, MeetingPreparationNotesStore, MeetingRelatedHistoryStore, MeetingSearchIndexStore, MeetingSearchStore, MeetingSeriesHistoryStore, MeetingStore, MeetingTranscriptReceiptStore, MeetingTranscriptStore, NewRecord } from "../../meetings/index.js";
+import type { Attachment, MeetingContextStore, MeetingParticipantSearchStore, MeetingPreparationContextStore, MeetingPreparationKnowledgeStore, MeetingPreparationNotesStore, MeetingRelatedHistoryStore, MeetingSearchIndexStore, MeetingSearchStore, MeetingSeriesHistoryStore, MeetingStatsStore, MeetingStore, MeetingTranscriptReceiptStore, MeetingTranscriptStore, NewRecord } from "../../meetings/index.js";
 import type { CacheDatabase } from "../driver.js";
 import { type MeetingContextReadCapabilities, type MeetingReadCapabilities } from "./meeting-reads.js";
 import type { StoreContext } from "./open.js";
@@ -11,7 +11,7 @@ export declare const saveAttachment: (database: CacheDatabase, type: string, par
 export declare const drainMeetingIndex: (database: CacheDatabase, batch?: number) => number;
 /** Each word of the query, as a prefix, all required. */
 export declare const wordsQuery: (query: string) => string | null;
-export type StoredMeetings = MeetingStore & MeetingPreparationContextStore & MeetingPreparationKnowledgeStore & MeetingPreparationNotesStore & MeetingRelatedHistoryStore & MeetingSeriesHistoryStore & MeetingTranscriptStore & MeetingReadCapabilities & MeetingContextReadCapabilities & MeetingParticipantSearchStore & MeetingSearchStore & MeetingTranscriptReceiptStore & MeetingContextStore & MeetingSearchIndexStore;
+export type StoredMeetings = MeetingStore & MeetingPreparationContextStore & MeetingPreparationKnowledgeStore & MeetingPreparationNotesStore & MeetingRelatedHistoryStore & MeetingSeriesHistoryStore & MeetingTranscriptStore & MeetingReadCapabilities & MeetingContextReadCapabilities & MeetingParticipantSearchStore & MeetingSearchStore & MeetingTranscriptReceiptStore & MeetingContextStore & MeetingSearchIndexStore & MeetingStatsStore;
 /** The `MeetingStore` of `src/meetings/` over the shared store. */
 export declare const meetingStoreOver: (context: StoreContext) => StoredMeetings;
 export {};

package/dist/store/sqlite/meetings.js

@@ -16,6 +16,7 @@ import { meetingPreparationNotesOver } from "./meeting-preparation-notes.js";
 import { meetingReadsOver } from "./meeting-reads.js";
 import { meetingRelatedHistoryOver } from "./meeting-related-history.js";
 import { meetingSeriesHistoryOver } from "./meeting-series-history.js";
+import { meetingStatsOver } from "./meeting-stats.js";
 import { invalidateMeetingStems } from "./meeting-stem-state.js";
 import { meetingOf, transcriptOf, transcriptRowOf } from "./meeting-values.js";
 import { queryFilter } from "./query-filter.js";
@@ -571,6 +572,7 @@ export const meetingStoreOver = (context) => {
         ...meetingPreparationNotesOver(context),
         ...meetingRelatedHistoryOver(context),
         ...meetingHitSearchOver(context),
+        ...meetingStatsOver(context),
         ...meetingParticipantSearchOver(context),
         ...meetingHitIndexOver(context),
         ...meetingContextLinksOver(context),

package/package.json

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