@wirecat/cli-core 0.379.0 → 0.380.0

package/CHANGELOG.md

@@ -7,6 +7,58 @@ shape of this file.
 
 ## Unreleased
 
+## 0.380.0 — 21.10.2026
+
+### Added
+
+- **Meetings import text transcripts.** `parseTranscriptText` reads the text form zoom-searcher wrote: the header
+  (`Встреча:` title, `Дата:` start as written, `Zoom ID:`, `Говорят:` speakers) and `[hh:mm:ss] Speaker: text`
+  blocks, a block running over several lines. `ImportFile.format: "text"` makes `importFiles` use it; `vtt` stays
+  the default. The file keeps start times only, so a line ends where the next begins.
+- **An import says the zone it read file times in, and a host can explain its file names.** `RunReport.timezone` is
+  set when every imported file's meeting carries one zone; `MeetingCommandDeps.importHelp` adds the host's note
+  (file name patterns, how their time is read) under `meetings import --help`.
+- **Meeting search finds words spread over neighbouring lines.** `"циан риелтор"~3` in a meeting query finds a
+  transcript line with one of the words when the others are at most three lines away in the same transcript; `~0`
+  is one line, any order; at most 20. The words widen to garbled spellings as single words do. It needs
+  `@wirecat/cli-base` 0.49.0 (`parseLucene({ proximity: true })`), now the pinned version and the peer range.
+  See [query language](docs/search/query-language.md#встречи).
+
+- **Meeting search finds words speech recognition garbled.** `meetings.searchHits` widens each query word of four
+  letters or more to stored words one stem edit away that a Russian dictionary does not know, and to stems one side
+  extends, so «риелтор» finds «реелтора», «рилторов» and «дриелтора», «циана» finds «цианом», and «договор» does not
+  find «поговорить». Hits come typed form first, then other forms, then garbled spellings; a widened hit carries `match: "corrected"` and `corrections`, and `meeting_hit` items show both. Number words never
+  widen, and match only their own forms («семь» finds «семи», not «семьдесят»). See [meetings](docs/dev/MEETINGS.md).
+- **Answers say which zone a typed date was read in, and the UTC window it gave** (cli-base `WC-TIME-3`, `WC-TIME-5`).
+  `stats charts`, the MCP `stats` tool and `contacts timeline` put `meta.timezone` (only when a value had no zone of
+  its own) and `meta.window: { since?, until? }` in UTC in their answers. `dateWindow` in `./cli`'s moment helpers
+  builds both from `--since-time`/`--until-time`. Other date filters follow.
+
+### Changed — may break callers
+
+- **Meeting search reads the messages query language.** `meetings.searchHits`, `search meetings` and MCP
+  `search_meetings` take `OR`, `(groups)`, `NOT`/`-word`, `"phrases"` (neighbouring words, any form), `exact:` and
+  `from:"Name"` — who said the line or wrote the chat message, a person through all their linked identities; an
+  ambiguous name is an error with the candidates. `:`, `(`, `"`, `-` and `AND`/`OR`/`NOT` in a meeting query are
+  now syntax, and a query of punctuation alone is a `validation_error`. `searchHits` also takes a `QueryAst`;
+  `meetingWordsQuery(text)` builds one from text that must stay plain words, as project discovery now does.
+  `MEETING_HIT_QUERY` and `parseMeetingQuery` are exported. See [query language](docs/search/query-language.md#встречи).
+
+- **Meeting search reads `exact:` and has new cursors.** `exact:word` and `exact:"two words"` in a
+  `meetings.searchHits` query keep those words to their typed form, where `exact` was a search word before. Exact
+  hits now come before widened ones, so cursors from earlier versions are refused; start the search again.
+
+### Fixed
+
+- **A recording archive schedule counts "today" in its own zone.** The window's end, its ten-year floor and its
+  look-back started from the UTC date, so a run between local midnight and UTC midnight worked on yesterday. The
+  schedule's `timeZone` was stored and never used for this.
+- **A Markdown chat archive says which zone its times are in.** The file printed local wall times with no zone; it
+  now has `Times are in <zone>.` under the title.
+- **`chats stats show` and `stats chats retention` read `--since-time`/`--until-time` in their `--timezone`.** They
+  used the computer's zone even when `--timezone` was given, and retention's `--until-time` dropped the day it named;
+  it now covers that whole local day.
+
 ## 0.379.0 — 21.10.2026
 
 ### Changed — may break callers

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/entities/index.d.ts

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

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

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

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

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

package/dist/mcp/tools/stats.js

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

package/dist/meetings/answers.d.ts

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

package/dist/meetings/answers.js

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

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

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

package/dist/meetings/cli/index.js

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

package/dist/meetings/cli/search.js

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

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

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

package/dist/meetings/hit-query.js

@@ -0,0 +1,58 @@
+import { defineQuery, parseLucene, queryError, validateQuery, } from "@wirecat/cli-base/query";
+const context = {
+    command: "search meetings",
+    guide: "https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md#встречи",
+};
+const words = ["term", "phrase"];
+/** A transcript line holds a sentence or two; further than this is a different part of the meeting. */
+export const MOST_LINES_APART = 20;
+const near = (node) => {
+    if (node.slop !== undefined && node.slop > MOST_LINES_APART)
+        queryError("query.invalid-number", node.span, `words at most ${MOST_LINES_APART} lines apart: "a b"~${MOST_LINES_APART}`, context);
+};
+/** The messages query language over meeting text: the same fields, a narrower set of operators. */
+export const MEETING_HIT_QUERY = defineQuery({
+    entity: "meeting_hit",
+    backend: "sql",
+    fields: [
+        {
+            name: "text",
+            type: "txt",
+            operators: words,
+            example: "text:budget",
+            relation: "a passage with the word in any form, or a spelling speech recognition garbled",
+            validate: near,
+        },
+        {
+            name: "exact",
+            type: "txt",
+            operators: words,
+            example: "exact:budget",
+            relation: "a passage with the word as typed: no other forms, no garbled spellings",
+            validate: near,
+        },
+        {
+            name: "from",
+            type: "kw",
+            operators: words,
+            example: 'from:"Alice Synthetic"',
+            relation: "a line said or a chat message written by this person; attendance is --identity-id",
+        },
+    ],
+});
+/** What a person typed: the CLI, MCP and batch queries. */
+export const parseMeetingQuery = (query) => validateQuery(parseLucene(query, { defaultField: "text", proximity: true, ...context }), MEETING_HIT_QUERY, context);
+/**
+ * Words from a name or a note, never parsed: a project called «C++ (beta)» must not become syntax. Each word is
+ * required, in any form.
+ */
+export const meetingWordsQuery = (text) => {
+    const found = text.match(/[\p{L}\p{N}\p{M}]+/gu) ?? [];
+    const span = { start: 0, end: text.length };
+    const clauses = found.map((value) => ({
+        occur: "must",
+        node: { kind: "predicate", field: "text", operator: "term", value, span },
+    }));
+    const root = clauses.length === 1 && clauses[0] ? clauses[0].node : { kind: "boolean", clauses, span };
+    return { version: 1, language: "lucene-v1", root };
+};

package/dist/meetings/import.d.ts

@@ -5,6 +5,8 @@ export interface ImportFile {
     content: string;
     participants?: ParticipantInput[];
     source?: string;
+    /** `vtt` (the default) or `text`, the form `parseTranscriptText` reads. */
+    format?: "vtt" | "text";
 }
 /** The caller reads files and supplies provider-neutral occurrence metadata. */
 export declare const importFiles: (files: ImportFile[], store: MeetingStore, now?: number) => Promise<RunReport>;

package/dist/meetings/import.js

@@ -1,17 +1,19 @@
 import { linkEvent } from "./events.js";
 import { transcriptInput } from "./ingest.js";
+import { parseTranscriptText } from "./transcript-text.js";
 import { parseVtt } from "./vtt.js";
 /** The caller reads files and supplies provider-neutral occurrence metadata. */
 export const importFiles = async (files, store, now = Date.now()) => {
     const report = { meetings: 0, participants: 0, transcriptRows: 0, summaries: 0, warnings: [] };
     for (const file of files) {
         try {
-            const lines = parseVtt(file.content);
+            const format = file.format ?? "vtt";
+            const lines = format === "text" ? parseTranscriptText(file.content).lines : parseVtt(file.content);
             const participants = file.participants ?? [];
             const details = await store.saveMeeting({
                 meeting: file.meeting,
                 participants: file.participants,
-                transcripts: [await transcriptInput(lines, participants, file.source ?? "file", file.content, "vtt")],
+                transcripts: [await transcriptInput(lines, participants, file.source ?? "file", file.content, format)],
                 now,
             });
             await linkEvent(store, details, now);
@@ -26,5 +28,9 @@ export const importFiles = async (files, store, now = Date.now()) => {
             });
         }
     }
+    const zones = new Set(files.map((file) => file.meeting.timezone).filter((zone) => zone !== null && zone !== undefined));
+    const [zone] = zones;
+    if (zones.size === 1 && zone)
+        report.timezone = zone;
     return report;
 };

package/dist/meetings/index.d.ts

@@ -6,6 +6,7 @@ export { linkEvent } from "./events.js";
 export { exportMeeting, type MeetingExport, type MeetingExportFormat, type MeetingExportOptions, serializeVtt, } from "./export.js";
 export { type FindingEvidence, type FindingOutcome, findingHash, MEETING_FINDINGS_KIND, type MeetingFactFinding, type MeetingFinding, type MeetingFindingsInput, type MeetingFindingsReceipt, type MeetingTaskFinding, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
 export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { type ImportFile, importFiles } from "./import.js";
 export { MEETING_QUERY, type MeetingItem, type MeetingOwner, meeting, meetingItem } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
@@ -41,6 +42,7 @@ export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validat
 export type { MeetingSource, SourceParticipant } from "./source.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";
 export { type MeetingMediaDescriptor, type MeetingRecognitionSegment, type MeetingTranscriptionContext, type MeetingTranscriptionOptions, type MeetingTranscriptionReceipt, type MeetingTranscriptionSource, transcribeMeeting, } from "./transcription.js";
 export { createUpcomingMeetingReader } from "./upcoming.js";
 export type { MeetingOccurrence, MeetingOccurrencePort, MeetingOccurrenceRead, MeetingOccurrenceSchedule, UpcomingMeetingRequest, UpcomingMeetingResult, } from "./upcoming-types.js";

package/dist/meetings/index.js

@@ -4,6 +4,7 @@ export { linkEvent } from "./events.js";
 export { exportMeeting, serializeVtt, } from "./export.js";
 export { findingHash, MEETING_FINDINGS_KIND, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
 export { findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { importFiles } from "./import.js";
 export { MEETING_QUERY, meeting, meetingItem } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
@@ -27,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 { parseTranscriptText, TranscriptTextError } from "./transcript-text.js";
 export { transcribeMeeting, } from "./transcription.js";
 export { createUpcomingMeetingReader } from "./upcoming.js";
 export { parseVtt, VttError } from "./vtt.js";

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

@@ -15,6 +15,7 @@ export declare const meetingSearchTool: {
             query: {
                 type: string;
                 minLength: number;
+                description: string;
             };
             meeting_id: {
                 type: string;
@@ -138,6 +139,11 @@ export declare const callMeetingSearchTool: (search: MeetingHitSearch, input: un
         id: string;
         excerpt: string;
         offset_ms: number | null;
+        match?: "corrected" | "words" | undefined;
+        corrections?: {
+            from: string;
+            to: string[];
+        }[] | undefined;
         source?: {
             ref: string;
             title: string | null;

package/dist/meetings/mcp/search.js

@@ -11,7 +11,11 @@ export const meetingSearchTool = {
     inputSchema: {
         type: "object",
         properties: {
-            query: { type: "string", minLength: 1 },
+            query: {
+                type: "string",
+                minLength: 1,
+                description: 'The messages query language: words (all required), OR, (groups), NOT or -word, "a phrase", "a b"~N for words within N transcript lines (at most 20), exact:word, from:"Name" for who said the line',
+            },
             meeting_id: integer,
             identity_id: integer,
             person_id: integer,

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

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

package/dist/meetings/pull.d.ts

@@ -9,6 +9,8 @@ export interface RunReport {
         externalId: string;
         message: string;
     }[];
+    /** An import whose files all read their start time in one zone names it; files carry no zone of their own. */
+    timezone?: string;
 }
 export interface PullOptions {
     accountId: number;

package/dist/meetings/recording-schedule.js

@@ -12,6 +12,8 @@ const clock = (now) => {
     return new Date(now);
 };
 const day = (instant) => instant.toISOString().slice(0, 10);
+/** The calendar day it is at `instant` in the schedule's own zone: the day the owner's daily run belongs to. */
+const localDay = (instant, timeZone) => new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(instant);
 const identity = (schedule) => createHash("sha256").update(JSON.stringify(schedule)).digest("hex");
 export const planRecordingArchiveSchedule = (input, options) => {
     const now = clock(options.now);
@@ -29,8 +31,8 @@ export const planRecordingArchiveSchedule = (input, options) => {
         fail("archive schedule requires a valid IANA time zone");
     }
     recordingWindows(input.from, input.from);
-    if (input.from <= day(now))
-        recordingWindows(input.from, day(now));
+    if (input.from <= localDay(now, input.timeZone))
+        recordingWindows(input.from, localDay(now, input.timeZone));
     const lookbackDays = input.lookbackDays ?? 7;
     const maxBytes = input.maxBytes ?? 20 * 1024 ** 3;
     if (!Number.isSafeInteger(lookbackDays) || lookbackDays < 0 || lookbackDays > 31)
@@ -76,11 +78,10 @@ export const parseRecordingArchiveSchedule = (value) => {
 export const recordingArchiveScheduleWindow = (value, options) => {
     const schedule = parseRecordingArchiveSchedule(value);
     const now = clock(options.now);
-    const through = day(now);
+    const through = localDay(now, schedule.timeZone);
     if (schedule.from > through)
         return null;
-    const floor = new Date(now);
-    floor.setUTCHours(0, 0, 0, 0);
+    const floor = new Date(`${through}T00:00:00Z`);
     // A running job ages beyond its original ten-year discovery interval; saved pending work survives separately.
     const month = floor.getUTCMonth();
     const date = floor.getUTCDate();