@wirecat/cli-core 0.563.0 → 0.565.0

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/mcp/passage.d.ts

@@ -57,7 +57,7 @@ export declare const callMeetingPassageTool: (read: MeetingPassageReader, input:
     }[];
     structuredContent: {
         error: {
-            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
+            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "conflict" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
             reason: string;
             message: string;
             param?: string | undefined;

package/dist/meetings/mcp/project-evidence.d.ts

@@ -51,7 +51,7 @@ export declare const callMeetingProjectEvidenceTool: (read: MeetingProjectDiscov
     }[];
     structuredContent: {
         error: {
-            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
+            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "conflict" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
             reason: string;
             message: string;
             param?: string | undefined;

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

@@ -94,7 +94,7 @@ export declare const callMeetingSearchTool: (search: MeetingHitSearch, input: un
     }[];
     structuredContent: {
         error: {
-            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
+            code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "conflict" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
             reason: string;
             message: string;
             param?: string | undefined;

package/dist/meetings/read-answers.d.ts

@@ -2,7 +2,7 @@ import * as v from "valibot";
 import type { MeetingLink } from "./links.js";
 import type { Event } from "./model.js";
 import type { MeetingReviewItem } from "./review.js";
-import type { MeetingSpeakerStats, MeetingStats } from "./stats.js";
+import type { MeetingCounts, MeetingSpeakerStats, MeetingStats } from "./stats.js";
 /** One meeting in `review`: what the store holds about it, never transcript text. */
 export declare const meetingReview: v.StrictObjectSchema<{
     readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
@@ -91,6 +91,27 @@ export declare const meetingStats: v.StrictObjectSchema<{
     }, undefined>, undefined>;
 }, undefined>;
 export declare const meetingStatsItem: (found: MeetingStats, top?: number) => v.InferOutput<typeof meetingStats>;
+/**
+ * `stats meetings history`: meetings, minutes and meetings with a transcript, in total and per day, week (its Monday)
+ * or series. `has_more` says `--limit` left rows out.
+ */
+export declare const meetingCounts: v.StrictObjectSchema<{
+    readonly by: v.PicklistSchema<["day", "week", "series"], undefined>;
+    readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly minutes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly mean_minutes: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly transcripts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly rows: v.ArraySchema<v.StrictObjectSchema<{
+        readonly key: v.StringSchema<undefined>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly minutes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly mean_minutes: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly transcripts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>, undefined>;
+    readonly has_more: v.BooleanSchema<undefined>;
+}, undefined>;
+export declare const meetingCountsItem: (found: MeetingCounts) => v.InferOutput<typeof meetingCounts>;
 /** `meetings people`: one page of participant observations whose name or email matches. */
 export declare const meetingParticipants: v.StrictObjectSchema<{
     readonly schema_version: v.LiteralSchema<1, undefined>;

package/dist/meetings/read-answers.js

@@ -113,6 +113,44 @@ export const meetingStatsItem = (found, top = 10) => ({
     weeks: found.weeks.map((week) => ({ week_start: week.weekStart, meetings: week.meetings, talk_ms: week.talkMs })),
     top_speakers: found.speakers.slice(0, top).map(meetingSpeakerItem),
 });
+const meetingCountsRow = v.strictObject({
+    key: text,
+    name: v.nullable(text),
+    meetings: count,
+    minutes: count,
+    mean_minutes: v.nullable(v.number()),
+    transcripts: count,
+});
+/**
+ * `stats meetings history`: meetings, minutes and meetings with a transcript, in total and per day, week (its Monday)
+ * or series. `has_more` says `--limit` left rows out.
+ */
+export const meetingCounts = v.strictObject({
+    by: v.picklist(["day", "week", "series"]),
+    meetings: count,
+    minutes: count,
+    mean_minutes: v.nullable(v.number()),
+    transcripts: count,
+    rows: v.array(meetingCountsRow),
+    has_more: v.boolean(),
+});
+const countsRowItem = (row) => ({
+    key: row.key,
+    name: row.name,
+    meetings: row.meetings,
+    minutes: row.minutes,
+    mean_minutes: row.meanMinutes,
+    transcripts: row.transcripts,
+});
+export const meetingCountsItem = (found) => ({
+    by: found.by,
+    meetings: found.meetings,
+    minutes: found.minutes,
+    mean_minutes: found.meanMinutes,
+    transcripts: found.transcripts,
+    rows: found.rows.map(countsRowItem),
+    has_more: found.hasMore,
+});
 const truncated = (...why) => v.nullable(v.picklist(why));
 /** `meetings people`: one page of participant observations whose name or email matches. */
 export const meetingParticipants = v.strictObject({

package/dist/meetings/stats.d.ts

@@ -48,9 +48,53 @@ export interface MeetingStats {
     speakers: MeetingSpeakerStats[];
     weeks: MeetingWeekStats[];
 }
+export type MeetingCountsGrouping = "day" | "week" | "series";
+export declare const MEETING_COUNTS_GROUPINGS: readonly MeetingCountsGrouping[];
+export interface MeetingCountsInput extends MeetingStatsSelection {
+    by: MeetingCountsGrouping;
+    /** The zone days and weeks are read in; UTC when not given. */
+    timeZone?: string;
+    /** Most rows: the newest days or weeks, or the busiest series (default 100). */
+    limit?: number;
+}
+/** One selected meeting as the counts need it; no title text but the series' or the meeting's own name. */
+export interface MeetingCountsMeeting {
+    startedAt: number | null;
+    /** `duration_ms`, else `ended_at - started_at`; `null` for a meeting with no end. */
+    durationMs: number | null;
+    transcribed: boolean;
+    seriesKey: string | null;
+    seriesTitle: string | null;
+}
+export interface MeetingCountsRow {
+    /** A day or the Monday of a week (`YYYY-MM-DD` in the zone), or `series:<external id>`, or `NO_SERIES`. */
+    key: string;
+    /** The series title under `series`; `null` otherwise. */
+    name: string | null;
+    meetings: number;
+    minutes: number;
+    /** Over the meetings with a duration; `null` when none has one. */
+    meanMinutes: number | null;
+    transcripts: number;
+}
+export interface MeetingCounts extends Omit<MeetingCountsRow, "key" | "name"> {
+    by: MeetingCountsGrouping;
+    timeZone: string;
+    rows: MeetingCountsRow[];
+    hasMore: boolean;
+}
 export interface MeetingStatsStore {
     meetingStats(input: MeetingStatsInput): Promise<MeetingStats>;
+    meetingCounts(input: MeetingCountsInput): Promise<MeetingCounts>;
 }
+/** The row of meetings outside any series, under `--by series`; a constant for the same reason as `UNKNOWN_SPEAKER`. */
+export declare const NO_SERIES = "no-series";
+/**
+ * Meetings, minutes and meetings with a transcript, in total and per day, week or series. A meeting with no end
+ * counts in `meetings` but not in `minutes` or the mean; one with no start counts in the totals and in its series,
+ * never in a day or week. Days and weeks with no meeting have no row.
+ */
+export declare const aggregateMeetingCounts: (meetings: readonly MeetingCountsMeeting[], by: MeetingCountsGrouping, timeZone?: string, limit?: number) => MeetingCounts;
 /**
  * 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

package/dist/meetings/stats.js

@@ -1,4 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
+export const MEETING_COUNTS_GROUPINGS = ["day", "week", "series"];
 const zoneOf = (timeZone) => {
     const zone = timeZone ?? "UTC";
     try {
@@ -15,6 +16,81 @@ const weekStart = (at, format) => {
     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);
 };
+const dayKey = (at, format) => {
+    const parts = Object.fromEntries(format.formatToParts(new Date(at)).map((part) => [part.type, part.value]));
+    return `${parts.year}-${parts.month}-${parts.day}`;
+};
+const zoneFormat = (zone) => new Intl.DateTimeFormat("en-US", {
+    timeZone: zone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    weekday: "short",
+});
+/** The row of meetings outside any series, under `--by series`; a constant for the same reason as `UNKNOWN_SPEAKER`. */
+export const NO_SERIES = "no-series";
+const MOST_COUNT_ROWS = 100;
+const minutesOf = (ms) => Math.round(ms / 60_000);
+const meanOf = (ms, timed) => (timed === 0 ? null : Math.round(ms / timed / 6_000) / 10);
+/**
+ * Meetings, minutes and meetings with a transcript, in total and per day, week or series. A meeting with no end
+ * counts in `meetings` but not in `minutes` or the mean; one with no start counts in the totals and in its series,
+ * never in a day or week. Days and weeks with no meeting have no row.
+ */
+export const aggregateMeetingCounts = (meetings, by, timeZone, limit = MOST_COUNT_ROWS) => {
+    if (!MEETING_COUNTS_GROUPINGS.includes(by))
+        throw new CliError("validation_error", `--by takes ${MEETING_COUNTS_GROUPINGS.join(", ")}`);
+    if (!Number.isSafeInteger(limit) || limit < 1)
+        throw new CliError("validation_error", "--limit is a positive number");
+    const zone = zoneOf(timeZone);
+    const format = zoneFormat(zone);
+    const sum = () => ({ meetings: 0, ms: 0, timed: 0, transcripts: 0 });
+    const add = (into, meeting) => {
+        into.meetings += 1;
+        if (meeting.durationMs !== null) {
+            into.ms += Math.max(0, meeting.durationMs);
+            into.timed += 1;
+        }
+        if (meeting.transcribed)
+            into.transcripts += 1;
+    };
+    const total = { ...sum(), name: null };
+    const groups = new Map();
+    for (const meeting of meetings) {
+        add(total, meeting);
+        const key = by === "series"
+            ? meeting.seriesKey === null
+                ? NO_SERIES
+                : `series:${meeting.seriesKey}`
+            : meeting.startedAt === null
+                ? null
+                : by === "day"
+                    ? dayKey(meeting.startedAt, format)
+                    : weekStart(meeting.startedAt, format);
+        if (key === null)
+            continue;
+        const group = groups.get(key) ?? { ...sum(), name: by === "series" ? meeting.seriesTitle : null };
+        add(group, meeting);
+        groups.set(key, group);
+    }
+    const ordered = [...groups.entries()].sort(([a, one], [b, other]) => by === "series" ? other.ms - one.ms || other.meetings - one.meetings || a.localeCompare(b) : b.localeCompare(a));
+    const kept = ordered.slice(0, limit);
+    if (by !== "series")
+        kept.reverse();
+    const counted = ({ meetings: count, ms, timed, transcripts }) => ({
+        meetings: count,
+        minutes: minutesOf(ms),
+        meanMinutes: meanOf(ms, timed),
+        transcripts,
+    });
+    return {
+        by,
+        timeZone: zone,
+        ...counted(total),
+        rows: kept.map(([key, group]) => ({ key, name: group.name, ...counted(group) })),
+        hasMore: ordered.length > limit,
+    };
+};
 /** 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
@@ -31,13 +107,7 @@ const speakerOf = (row) => row.personId !== null
  */
 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 format = zoneFormat(zone);
     const speakers = new Map();
     const weeks = new Map();
     const meetings = new Set();

package/dist/search/lucene/registry.js

@@ -192,7 +192,7 @@ export const QUERY_FIELDS = [
     {
         name: "has",
         example: "has:file",
-        index: "attachments / messages_fts links",
+        index: "attachments / messages_fts links / message_transcripts",
         aliases: [],
         type: "enum",
         operators: terms,
@@ -212,6 +212,7 @@ export const QUERY_FIELDS = [
             "contact",
             "location",
             "poll",
+            "transcript",
         ],
     },
     {

package/dist/search/question-plan.d.ts

@@ -14,3 +14,19 @@ export declare function planQuestion(text: string, strict?: boolean): {
     removed: string[];
     aliases: string[];
 };
+/**
+ * Text as a question is searched. Its own "?" would parse as a one-character wildcard and send it to strict search
+ * (BUG-395); the colon of a time or ratio ("22:00", "1:1") would parse as a field and fail the whole search, and
+ * escaped it is syntax again, so it splits the numbers (BUG-450). A quoted timestamp keeps its colons (BUG-458).
+ */
+export declare const questionText: (text: string) => string;
+/** The words a question's partial lookup takes: its content words and the words its aliases stand for. */
+export declare const lookupTerms: (plan: ReturnType<typeof planQuestion>) => string[];
+/** Any of the words, and every field the question names. */
+export declare const anyOfTerms: (terms: string[], scope: string) => string;
+/**
+ * The partial lookup `search messages --discover` runs, for a store that has no discovery of its own: a question's
+ * content words joined by OR, its fields kept. `undefined` when the text is not a question in natural language, so
+ * words and query syntax are searched as typed.
+ */
+export declare const questionLookup: (text: string) => string | undefined;

package/dist/search/question-plan.js

@@ -1,3 +1,4 @@
+import { CliError } from "@wirecat/cli-base";
 import { implicitTextTerms, parseLucene, walkQuery } from "@wirecat/cli-base/query";
 import { normalize } from "../store/normalize.js";
 import { MESSAGE_PARSING } from "./lucene/types.js";
@@ -129,3 +130,36 @@ export function planQuestion(text, strict = false) {
     const queries = [...new Set([render(terms), render(alias)])].slice(0, 2);
     return { changed: true, natural: true, queries, scope, terms, rankingTerms: original, removed, aliases: changes };
 }
+/**
+ * Text as a question is searched. Its own "?" would parse as a one-character wildcard and send it to strict search
+ * (BUG-395); the colon of a time or ratio ("22:00", "1:1") would parse as a field and fail the whole search, and
+ * escaped it is syntax again, so it splits the numbers (BUG-450). A quoted timestamp keeps its colons (BUG-458).
+ */
+export const questionText = (text) => text
+    .replace(/(?<=\p{L})\?(?=\s|$)/gu, "")
+    .replace(/"(?:[^"\\]|\\.)*"|(?<=\d):(?=\d)/gu, (found) => (found === ":" ? " " : found));
+/** The words a question's partial lookup takes: its content words and the words its aliases stand for. */
+export const lookupTerms = (plan) => [
+    ...new Set(plan.terms.concat(plan.aliases.flatMap((alias) => words(alias.split(" -> ")[1] ?? "")))),
+];
+/** Any of the words, and every field the question names. */
+export const anyOfTerms = (terms, scope) => `(${terms.join(" OR ")})${scope ? ` ${scope}` : ""}`;
+/**
+ * The partial lookup `search messages --discover` runs, for a store that has no discovery of its own: a question's
+ * content words joined by OR, its fields kept. `undefined` when the text is not a question in natural language, so
+ * words and query syntax are searched as typed.
+ */
+export const questionLookup = (text) => {
+    let plan;
+    try {
+        plan = planQuestion(questionText(text));
+    }
+    catch (error) {
+        // A query the messages language refuses is not a plain question; the store's own parser answers it.
+        if (error instanceof CliError)
+            return undefined;
+        throw error;
+    }
+    const terms = plan.changed ? lookupTerms(plan) : [];
+    return terms.length ? anyOfTerms(terms, plan.scope) : undefined;
+};

package/dist/services/events-search.d.ts

@@ -8,6 +8,8 @@ export interface EventsQuery {
     accounts?: readonly AccountKey[];
     /** Every word as written: no stems. */
     exact?: boolean;
+    /** A question typed as a sentence finds what holds some of its words, as `search messages --discover` does. */
+    discover?: boolean;
     /** Latest start first instead of best first. */
     newest?: boolean;
     /** For `date:`, which reads an event's start — the zone a bare day is read in. */
@@ -43,6 +45,8 @@ export interface FoundEvent {
     /** When the store's copy last changed. */
     updated_at: string;
     found_by: ("words" | "meaning")[];
+    /** The cosine of its series' nearest piece, when meaning found it: comparable with other records under the same model. */
+    meaning_score?: number;
 }
 export interface EventsFound {
     query: string;
@@ -64,4 +68,4 @@ export declare const foundEvent: (hit: Omit<EventHit, "relevance">, query: strin
  * by reciprocal rank: title, cleaned description, place and attendees' names. The occurrences of one series are one
  * hit. Working location, focus time, out of office, birthdays and busy-only slots are never found.
  */
-export declare const searchEvents: (store: MessageStore, query: string, { limit, offset, accounts, exact, newest, timezone, signal, candidates, env, command, embedders, }?: EventsQuery) => Promise<EventsFound>;
+export declare const searchEvents: (store: MessageStore, query: string, { limit, offset, accounts, exact, discover, newest, timezone, signal, candidates, env, command, embedders, }?: EventsQuery) => Promise<EventsFound>;

package/dist/services/events-search.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { kindIn } from "../domain/providers.js";
 import { meaningFloor } from "../embeddings/models.js";
+import { questionLookup, questionText } from "../search/question-plan.js";
 import { excerpt } from "./excerpt.js";
 import { localModel, RRF_K, storeQuery, withLocal } from "./notes-search.js";
 import { plainQueryWords } from "./notes-title-tier.js";
@@ -51,17 +52,18 @@ const keyOf = ({ event }) => event.eventSeriesId === null ? `e${event.id}` : `s$
  * by reciprocal rank: title, cleaned description, place and attendees' names. The occurrences of one series are one
  * hit. Working location, focus time, out of office, birthdays and busy-only slots are never found.
  */
-export const searchEvents = async (store, query, { limit = 20, offset = 0, accounts, exact, newest, timezone, signal, candidates, env, command, embedders, } = {}) => {
+export const searchEvents = async (store, query, { limit = 20, offset = 0, accounts, exact, discover, newest, timezone, signal, candidates, env, command, embedders, } = {}) => {
     if (!query.trim())
         throw new CliError("validation_error", "say what to find in the events");
-    const { root, stemmer } = await storeQuery(store, query, {
+    const asked = discover && !exact && !newest ? questionLookup(query) : undefined;
+    const { root, stemmer } = await storeQuery(store, asked ?? query, {
         ...(exact ? { exact: true } : {}),
         ...(timezone === undefined ? {} : { timezone }),
     });
     const accountIds = accounts === undefined ? undefined : await accountIdsOf(store, accounts);
     if (accountIds?.length === 0)
         return { query, by: "words", hits: [], has_more: false };
-    const words = plainQueryWords(query);
+    const words = plainQueryWords(asked === undefined ? query : questionText(query));
     const window = offset + limit;
     let meaningSkipped;
     let meaning;
@@ -118,12 +120,16 @@ export const searchEvents = async (store, query, { limit = 20, offset = 0, accou
     });
     add(found.items, "words");
     add(meaning, "meaning");
+    const cosines = new Map(meaning.map((hit) => [keyOf(hit), hit.score]));
     const ordered = [...ranked.values()].sort((a, b) => b.score - a.score);
     const hasMore = ordered.length > window || found.hasMore;
     return {
         query,
         by,
-        hits: ordered.slice(offset, window).map(({ hit, by: halves }) => foundEvent(hit, query, halves)),
+        hits: ordered.slice(offset, window).map(({ hit, by: halves }) => {
+            const cosine = cosines.get(keyOf(hit));
+            return { ...foundEvent(hit, query, halves), ...(cosine === undefined ? {} : { meaning_score: cosine }) };
+        }),
         has_more: hasMore,
         ...(hasMore && window <= MAX_EVENTS_OFFSET ? { next_offset: window } : {}),
         ...truncated,

package/dist/services/index.d.ts

@@ -87,7 +87,7 @@ export { createMeetingProjectCandidateReader } from "./meeting-project-candidate
 export { readMeetingProjectDiscovery } from "./meeting-project-discovery.js";
 export { type MeetingReviewRequest, readMeetingReview } from "./meeting-review.js";
 export { type MeetingSearchesService, type MeetingSearchParams, meetingSearchesService, type SavedMeetingSearch, } from "./meeting-searches.js";
-export { type MeetingStatsRequest, readMeetingStats } from "./meeting-stats.js";
+export { type MeetingCountsRequest, type MeetingStatsRequest, readMeetingCounts, 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

@@ -65,7 +65,7 @@ export { createMeetingProjectCandidateReader } from "./meeting-project-candidate
 export { readMeetingProjectDiscovery } from "./meeting-project-discovery.js";
 export { readMeetingReview } from "./meeting-review.js";
 export { meetingSearchesService, } from "./meeting-searches.js";
-export { readMeetingStats } from "./meeting-stats.js";
+export { readMeetingCounts, 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";