@wirecat/cli-core 0.383.0 → 0.384.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ shape of this file.
 
 ## Unreleased
 
+## 0.384.0 — 22.10.2026
+
+### Added
+
+- **More commands say how they read a typed date** (WC-TIME-3, WC-TIME-5): `meta.window` gives the UTC bounds they
+  used, and `meta.timezone` names the zone a value without its own zone was read in. Now: `moderate` (the bot's and
+  the admin's), the bot's `store fetch`, `store export`, `messages sync`, `stats chats show`, `contacts context`,
+  `search conversations`, `replies test` (its 7-day default window too), `runs search`, `stats chats retention`, the
+  administrator reports (`stats messages unanswered`, `stats contacts responses`, `stats chats newcomers`,
+  `stats messages discussion`), `search meetings` (also in `meetings batch`; over MCP only the window, since it takes
+  epoch times), and a `time:` or `date:` term in `chats events`, `chats members history`, `inbox` and `review`.
+  `search conversations` now reads a date alone in its `--timezone` when one is given. A host of `search meetings`
+  passes `meetingSearchMeta(options)` to `meetingHitsList` to report the same.
+
 ## 0.383.0 — 22.10.2026
 
 ### Added

package/dist/cli/bot/moderation.js

@@ -7,7 +7,7 @@ import { defaultRules, ModerationRules, moderationPathFor, RULE_KEYS } from "../
 import { moderateWith } from "../../moderation/run.js";
 import { guardedWrite } from "../../sends/guarded.js";
 import { newOperationId } from "../../sends/send-id.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { environmentOf } from "../context.js";
 import { grantsAuthority, LOCAL_READ, LOCAL_WRITE, ownerOnlyOption, REMOTE_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
@@ -155,6 +155,7 @@ export const botModerateCommand = (bot) => annotate(new Command("moderate"), { e
     // An in-process caller's answer counts under --json too: it is not a terminal that could wait for ever.
     const given = environmentOf(this).answer;
     const ask = async (question) => (given ? await given(question) : await answerOf(this, question));
+    const window = dateWindow(options.sinceTime === undefined ? {} : { sinceTime: options.sinceTime });
     await context.run(async (events) => {
         const adapter = await context.authenticated({ events });
         const botId = await botIdOf(context, adapter);
@@ -169,7 +170,7 @@ export const botModerateCommand = (bot) => annotate(new Command("moderate"), { e
             commandFor: (group, finding) => finding.action === "delete"
                 ? `${context.words} messages delete ${group} ${finding.messageId} --allow-dangerous`
                 : `${context.words} chats members remove ${group} ${finding.personId}`,
-            ...(options.sinceTime === undefined ? {} : { since: momentOf(options.sinceTime, "--since-time") }),
+            ...(window.since === undefined ? {} : { since: window.since }),
             dryRun: options.dryRun === true,
             allowDangerous: options.allowDangerous === true,
             maxActions,
@@ -188,7 +189,7 @@ export const botModerateCommand = (bot) => annotate(new Command("moderate"), { e
                 ...(row.reason ? { why: row.reason } : {}),
             })));
         else
-            renderAnswer(this, context, itemOf({ chat_id: chatId, rows: snakeKeys(rows) }));
+            renderAnswer(this, context, itemOf({ chat_id: chatId, rows: snakeKeys(rows) }, { meta: window.meta }));
         for (const note of notes)
             context.renderer.note(note);
     });

package/dist/cli/bot/store.js

@@ -3,9 +3,9 @@ import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
 import { parseDuration } from "../../domain/duration.js";
 import { fetchInto } from "../../services/archive.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { FETCH } from "../effects.js";
-import { renderItem } from "../messenger/chat-answers.js";
+import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { stopOnSignal } from "../messenger/patience.js";
 import { botContext, online } from "./context.js";
 import { botCan, botIdOf } from "./messages.js";
@@ -37,7 +37,8 @@ export const botStoreCommand = (bot, fetching) => {
             throw new CliError("validation_error", "give --since-time or --last, not both: how far back the fetch goes");
         }
         const pauseMs = parseDuration(options.pause, "--pause");
-        const sinceMs = options.sinceTime === undefined ? undefined : momentOf(options.sinceTime, "--since-time");
+        const bounds = dateWindow(options.sinceTime === undefined ? {} : { sinceTime: options.sinceTime });
+        const sinceMs = bounds.since;
         const context = online(botContext(this, bot), this);
         const ref = context.chatRef(chat);
         const stop = stopOnSignal(this);
@@ -73,7 +74,7 @@ export const botStoreCommand = (bot, fetching) => {
                         stop: stop.signal,
                         onPage: () => { },
                     }));
-                    renderItem(this, context, result);
+                    renderAnswer(this, context, itemOf(snakeKeys(result), { meta: bounds.meta }));
                 }
                 finally {
                     await adapter.close();

package/dist/cli/list-query.d.ts

@@ -44,10 +44,20 @@ export declare const nativeTerms: (ast: QueryAst | undefined, command: string) =
  * as validation already accepts them. A range or wildcard is refused rather than read as a value.
  */
 export declare const queryTerms: (words: QueryWords, registry: QueryRegistry, command: string) => Map<string, string>;
-/** A `time` term as epoch ms bounds: `time>=7d`, `time:[2026-10-01 TO 2026-10-07]`, `time:today`. */
+/**
+ * A `time` term as epoch ms bounds: `time>=7d`, `time:[2026-10-01 TO 2026-10-07]`, `time:today`, and the `meta`
+ * an answer reports them by: the zone calendar words and bare dates were read in, and the bounds in UTC.
+ */
 export declare const timeBounds: (term: Predicate | undefined, zone?: string) => {
     since?: number;
     until?: number;
+    meta?: {
+        timezone: string;
+        window: {
+            since?: string;
+            until?: string;
+        };
+    };
 };
 /** A text term as the plain words a provider searches by: `name:ana`, `name:"Ana K"`, `name:*ana*`. */
 export declare const searchText: (term: Predicate | undefined) => string | undefined;

package/dist/cli/list-query.js

@@ -130,7 +130,10 @@ export const queryTerms = (words, registry, command) => {
     }
     return terms;
 };
-/** A `time` term as epoch ms bounds: `time>=7d`, `time:[2026-10-01 TO 2026-10-07]`, `time:today`. */
+/**
+ * A `time` term as epoch ms bounds: `time>=7d`, `time:[2026-10-01 TO 2026-10-07]`, `time:today`, and the `meta`
+ * an answer reports them by: the zone calendar words and bare dates were read in, and the bounds in UTC.
+ */
 export const timeBounds = (term, zone = timezoneOf()) => {
     if (!term)
         return {};
@@ -139,6 +142,13 @@ export const timeBounds = (term, zone = timezoneOf()) => {
     return {
         ...(range.lower === undefined ? {} : { since: range.lower }),
         ...(range.upper === undefined ? {} : { until: range.upper }),
+        meta: {
+            timezone: zone,
+            window: {
+                ...(range.lower === undefined ? {} : { since: new Date(range.lower).toISOString() }),
+                ...(range.upper === undefined ? {} : { until: new Date(range.upper).toISOString() }),
+            },
+        },
     };
 };
 /** A text term as the plain words a provider searches by: `name:ana`, `name:"Ana K"`, `name:*ana*`. */

package/dist/cli/meeting-batch.js

@@ -2,7 +2,7 @@ import { BATCH_LIMITS, CliError, prepareBatch, runBatch, } from "@wirecat/cli-ba
 import { annotate } from "@wirecat/cli-base/commands";
 import { Command, Option } from "commander";
 import { failureContext } from "../errors/reasons.js";
-import { createMeetingPassageCommand, createMeetingSearchCommand, meetingHitSearchRequest, meetingPassageRequest, meetingSearchArguments, } from "../meetings/cli/index.js";
+import { createMeetingPassageCommand, createMeetingSearchCommand, meetingHitSearchRequest, meetingPassageRequest, meetingSearchArguments, meetingSearchMeta, } from "../meetings/cli/index.js";
 import { meetingHitsList, parseMeetingReference, } from "../meetings/index.js";
 import { formatMeetingEvidenceText, formatMeetingPassage } from "../services/meeting-passage-format.js";
 import { itemOf, listOf } from "./envelope.js";
@@ -48,6 +48,7 @@ const handlers = (reader, meta) => {
                             ...meetingHitsList(found, request.limit ?? 100, "search meetings", meetingSearchArguments(query, flags)),
                             meta: {
                                 ...meta(),
+                                ...meetingSearchMeta(flags),
                                 complete,
                                 ...(!complete ? { issues: [{ code: "invalid_response", source: "meeting-index" }] } : {}),
                             },

package/dist/cli/messenger/admin-moderation-command.js

@@ -3,7 +3,7 @@ import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
 import { describe, MAX_ACTIONS } from "../../moderation/check.js";
 import { RULE_KEYS } from "../../moderation/rules.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { grantsAuthority, LOCAL_READ, LOCAL_WRITE, REMOTE_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { answerOf } from "./ask.js";
@@ -57,8 +57,9 @@ export const moderateCommand = (messenger) => annotate(new Command("moderate"),
     if (!Number.isInteger(maxActions) || maxActions < 0) {
         throw new CliError("validation_error", `--max-actions takes a whole number — got ${String(options.maxActions)}`);
     }
+    const window = dateWindow(options.sinceTime === undefined ? {} : { sinceTime: options.sinceTime });
     const { chatId, rows, notes } = await context.withServices((services) => services.moderation.moderate(chat, {
-        ...(options.sinceTime === undefined ? {} : { since: momentOf(options.sinceTime, "--since-time") }),
+        ...(window.since === undefined ? {} : { since: window.since }),
         dryRun: options.dryRun === true,
         allowDangerous: options.allowDangerous === true,
         maxActions,
@@ -69,7 +70,7 @@ export const moderateCommand = (messenger) => annotate(new Command("moderate"),
             return /^\s*y(es)?\s*$/i.test(answer);
         },
     }));
-    renderAnswer(this, context, itemOf(snakeKeys({ chatId, rows })), () => rows
+    renderAnswer(this, context, itemOf(snakeKeys({ chatId, rows }), { meta: window.meta }), () => rows
         .map((row) => [row.kind, row.personName ?? row.personId, row.rule, row.action, row.outcome, row.reason ?? ""]
         .join("  ")
         .trimEnd())

package/dist/cli/messenger/archive-commands.js

@@ -9,7 +9,7 @@ import { renderMessages } from "../../render/messages.js";
 import { seal } from "../../sealed.js";
 import { CHAT_KINDS } from "../../services/chats.js";
 import { kindsOf } from "../../services/inbox.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { destroysNothing, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { jobsCommand } from "./backfill-command.js";
@@ -185,7 +185,8 @@ const exportCommand = (messenger) => destroysNothing(annotate(new Command("expor
     }
     const password = encrypt ? await passwordOf(this, { twice: true }) : undefined;
     const chat = chats[0];
-    const from = since === undefined ? undefined : new Date(momentOf(since, "--since-time")).toISOString();
+    const window = dateWindow(since === undefined ? {} : { sinceTime: since });
+    const from = window.since === undefined ? undefined : new Date(window.since).toISOString();
     const { account, title, messages } = await context.withServices((services) => services.archive.export(chat, from === undefined ? {} : { since: from }));
     if (output !== undefined) {
         const path = resolve(output);
@@ -210,7 +211,7 @@ const exportCommand = (messenger) => destroysNothing(annotate(new Command("expor
             format: format ?? "jsonl",
             count: messages.length,
             ...(password === undefined ? {} : { encrypted: true }),
-        }));
+        }, { meta: window.meta }));
         return;
     }
     if (format === "markdown")
@@ -223,6 +224,7 @@ const exportCommand = (messenger) => destroysNothing(annotate(new Command("expor
             items: messageItems(messages, account),
             limit: Math.max(1, messages.length),
             has_more: false,
+            meta: window.meta,
         }));
     else
         context.streams.data(renderMessages(messages, {

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

@@ -9,7 +9,7 @@ import { isCliFailure } from "../../errors/failures.js";
 import { envName } from "../../ports/app.js";
 import { FETCHING } from "../../services/archive.js";
 import { JOBS_QUERY, jobItems } from "../../services/job-query.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { validateCatchUpBounds } from "../../services/search-catchup.js";
 import { applyTaskRulesSinceLastPass } from "../../services/task-rules.js";
 import { environmentOf } from "../context.js";
@@ -72,8 +72,9 @@ export const syncCommand = (messenger) => {
         }
         const limit = sizes.limit ?? fetching.maxPages * fetching.page;
         const pauseMs = parseDuration(pause, "--pause");
-        const window = since ?? (all && last === undefined ? ALL_SINCE : undefined);
-        const sinceMs = window === undefined ? undefined : momentOf(window, "--since-time");
+        const from = since ?? (all && last === undefined ? ALL_SINCE : undefined);
+        const window = dateWindow(from === undefined ? {} : { sinceTime: from });
+        const sinceMs = window.since;
         const context = messengerContext(this, messenger);
         const prepare = catchUp ?? context.settings.searchCatchUp ?? false;
         const preparation = {
@@ -123,7 +124,10 @@ export const syncCommand = (messenger) => {
                 pageSize,
                 ...(last === undefined ? {} : { last }),
             });
-            renderAnswer(this, context, itemOf(snakeKeys(started), { next: [nextStep("store.job", { args: { job: started.job } })] }));
+            renderAnswer(this, context, itemOf(snakeKeys(started), {
+                next: [nextStep("store.job", { args: { job: started.job } })],
+                meta: window.meta,
+            }));
             return;
         }
         const jobs = jobsDir(messenger.app, context.env);
@@ -164,6 +168,7 @@ export const syncCommand = (messenger) => {
                         : []),
                     ...(toReview > 0 ? [nextStep("mentions.review", { args: { new: true }, values: { shown } })] : []),
                 ],
+                meta: window.meta,
             }));
             if (tasks?.held)
                 context.renderer.note(`the first sync left ${tasks.held} possible task(s) in ${tasks.heldChats ?? 0} chat(s) unopened ` +

package/dist/cli/messenger/catch-up-answers.d.ts

@@ -1,3 +1,4 @@
+import type { Meta } from "@wirecat/cli-base/standards";
 import type { Inbox, Review } from "../../domain/models.js";
 import { type Hearing } from "../../speech/hearing.js";
 import type { AccountKey } from "../../store/store.js";
@@ -10,8 +11,9 @@ export declare const REVIEW_QUERY: import("@wirecat/cli-base/query").QueryRegist
 export declare const catchUpQuery: (words: QueryWords, registry: typeof INBOX_QUERY, command: string) => {
     since?: number;
     chat?: string;
+    meta?: Partial<Meta>;
 };
-export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, reader: AccountKey, transcribe: boolean) => import("../envelope.js").ListBody<{
+export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, reader: AccountKey, transcribe: boolean, meta?: Partial<Meta>) => import("../envelope.js").ListBody<{
     ref: string;
     chat_id: string;
     chat_title: string | null | undefined;
@@ -51,10 +53,11 @@ export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, r
  * A review the next one goes on from: from `until` when nothing was left out, else from the same start again.
  * Saved points (`--new`) carry this themselves, and an `--unanswered` look is not a review to continue.
  */
-export declare const reviewAnswer: (found: Review, hearing: Hearing | undefined, reader: AccountKey, { transcribe, fresh, chat }: {
+export declare const reviewAnswer: (found: Review, hearing: Hearing | undefined, reader: AccountKey, { transcribe, fresh, chat, meta }: {
     transcribe: boolean;
     fresh: boolean;
     chat?: string;
+    meta?: Partial<Meta>;
 }) => import("../envelope.js").ListBody<{
     ref: string;
     chat_id: string;

package/dist/cli/messenger/catch-up-answers.js

@@ -17,13 +17,17 @@ export const REVIEW_QUERY = defineQuery({
 export const catchUpQuery = (words, registry, command) => {
     const terms = nativeTerms(listQuery(typedQuery(words), registry, command), command);
     const term = terms.get("date");
-    const { since, until } = timeBounds(term);
+    const { since, until, meta } = timeBounds(term);
     if (term && (until !== undefined || since === undefined))
         queryError("query.unsupported-operator", term.span, `${command} reads from a point on: date>2h, not an end`, {
             command,
         });
     const chat = terms.get("chat")?.value;
-    return { ...(since === undefined ? {} : { since }), ...(chat === undefined ? {} : { chat }) };
+    return {
+        ...(since === undefined ? {} : { since }),
+        ...(chat === undefined ? {} : { chat }),
+        ...(meta === undefined ? {} : { meta }),
+    };
 };
 const summaryOf = (message, reader) => {
     const { ref, chat_id, chat_title, timestamp, sender_name, outgoing, text, transcript, attachments } = messageItem(message, reader);
@@ -44,7 +48,7 @@ const nameOf = (chat) => chat.title ?? chat.id;
  * What every catch-up answer shares: the messages, oldest first, each naming its chat; what was left out as
  * `missing`; and a chat cut short as a `messages.list` step, after the steps the command puts first.
  */
-const catchUpList = (command, found, hearing, reader, { transcribe, first = [] }) => {
+const catchUpList = (command, found, hearing, reader, { transcribe, first = [], meta = {} }) => {
     const read = found.chats
         .flatMap((chat) => heard(chat.messages, hearing).map((message) => ({ ...message, chatTitle: chat.title })))
         .sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
@@ -73,16 +77,16 @@ const catchUpList = (command, found, hearing, reader, { transcribe, first = [] }
         has_more: false,
         next: [...first, ...cut.map((chat) => nextStep("messages.list", { args: { chat: chat.id } }))],
         missing,
-        ...(found.partial ? { meta: { truncated: true } } : {}),
+        meta: { ...meta, ...(found.partial ? { truncated: true } : {}) },
     });
 };
-export const inboxAnswer = (inbox, hearing, reader, transcribe) => catchUpList("inbox", inbox, hearing, reader, { transcribe });
+export const inboxAnswer = (inbox, hearing, reader, transcribe, meta = {}) => catchUpList("inbox", inbox, hearing, reader, { transcribe, meta });
 const quoted = (value) => `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
 /**
  * A review the next one goes on from: from `until` when nothing was left out, else from the same start again.
  * Saved points (`--new`) carry this themselves, and an `--unanswered` look is not a review to continue.
  */
-export const reviewAnswer = (found, hearing, reader, { transcribe, fresh, chat }) => {
+export const reviewAnswer = (found, hearing, reader, { transcribe, fresh, chat, meta }) => {
     const continues = !fresh && found.unanswered === undefined;
     const query = [
         `date>${quoted(found.complete ? found.until : found.since)}`,
@@ -91,5 +95,6 @@ export const reviewAnswer = (found, hearing, reader, { transcribe, fresh, chat }
     return catchUpList("review", found, hearing, reader, {
         transcribe,
         first: continues ? [nextStep("review.next", { args: { query: query.join(" ") } })] : [],
+        ...(meta === undefined ? {} : { meta }),
     });
 };

package/dist/cli/messenger/chat-lists.js

@@ -18,9 +18,11 @@ export const chatsList = async (services, query, paging) => {
 };
 export const chatEvents = async (services, chat, query) => {
     const terms = nativeTerms(listQuery(typedQuery(query), EVENTS_QUERY, "chats events"), "chats events");
-    const { since } = timeBounds(terms.get("time"));
+    const { since, meta } = timeBounds(terms.get("time"));
     const found = await services.chats.events(chat, since === undefined ? {} : { since });
-    return wholeList("chats events", found.events.map((one) => chatEventAnswer(found.chatId, one)), found.more ? { meta: { truncated: true } } : {});
+    return wholeList("chats events", found.events.map((one) => chatEventAnswer(found.chatId, one)), {
+        meta: { ...meta, ...(found.more ? { truncated: true } : {}) },
+    });
 };
 export const membersList = async (services, chat, paging) => {
     const { limit, page, all } = paging;
@@ -33,11 +35,14 @@ export const membersList = async (services, chat, paging) => {
 };
 export const membersHistory = async (services, chat, query) => {
     const terms = nativeTerms(listQuery(typedQuery(query), HISTORY_QUERY, "chats members history"), "chats members history");
-    const { since } = timeBounds(terms.get("time"));
+    const { since, meta } = timeBounds(terms.get("time"));
     const found = await services.chats.memberHistory(chat, since === undefined ? {} : { since });
-    return wholeList("chats members history", found.events.map((one) => memberEventAnswer(found.chatId, one)), found.events.length === 0
-        ? { next: [nextStep("chats.members-fetch", { args: { chat: found.chatId, track: true } })] }
-        : {});
+    return wholeList("chats members history", found.events.map((one) => memberEventAnswer(found.chatId, one)), {
+        ...(found.events.length === 0
+            ? { next: [nextStep("chats.members-fetch", { args: { chat: found.chatId, track: true } })] }
+            : {}),
+        ...(meta ? { meta } : {}),
+    });
 };
 export const membersAudit = async (services, chat, query, options) => {
     const minScore = scoreFloor(listQuery(typedQuery(query), AUDIT_QUERY, "chats members audit"));

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

@@ -2,7 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
 import { EVENTS_DAYS } from "../../services/chats.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { REMOTE_READ } from "../effects.js";
 import { renderAnswer } from "../envelope.js";
 import { messengerContext } from "./context.js";
@@ -19,13 +19,13 @@ export const statsCommand = (messenger) => annotate(new Command("show"), { effec
     const context = messengerContext(this, messenger);
     const { sinceTime, by, timezone } = this.opts();
     refuseJsonl(context.format);
+    const window = dateWindow({
+        ...(sinceTime === undefined ? {} : { sinceTime }),
+        ...(timezone === undefined ? {} : { zone: timezone }),
+    });
     const { stats, account } = await context.withServices(async (services) => ({
         stats: await services.chats.stats(chat, {
-            ...(sinceTime === undefined
-                ? {}
-                : {
-                    since: momentOf(sinceTime, "--since-time", Date.now(), timezone === undefined ? {} : { zone: timezone }),
-                }),
+            ...(window.since === undefined ? {} : { since: window.since }),
             ...(by ? { by } : {}),
             ...(timezone === undefined ? {} : { timezone }),
         }),
@@ -37,7 +37,7 @@ export const statsCommand = (messenger) => annotate(new Command("show"), { effec
         context.renderer.note("the messenger stopped reading joins and leaves before the period's start — those are lower bounds");
     if (!stats.members && !stats.membersUnrecorded)
         context.renderer.note("joins and leaves were not asked of the messenger");
-    renderAnswer(this, context, chatStatsAnswer(stats, account), () => view(stats));
+    renderAnswer(this, context, chatStatsAnswer(stats, account, window.meta), () => view(stats));
 });
 const view = (stats) => {
     const { questions, members } = stats;

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 { dateWindow, momentOf } from "../../services/moment.js";
+import { dateWindow } 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";
@@ -119,10 +119,11 @@ export const contactsCommand = (messenger) => {
             }));
             return;
         }
+        const window = dateWindow(sinceTime === undefined ? {} : { sinceTime });
         const found = await context.withServices((services) => services.people.context(person, {
             messages: limit ?? CONTEXT_MESSAGES,
             bytes: CONTEXT_BYTES,
-            ...(sinceTime === undefined ? {} : { since: momentOf(sinceTime, "--since-time") }),
+            ...(window.since === undefined ? {} : { since: window.since }),
         }));
         const { hasMore, ...rest } = found;
         renderAnswer(this, context, itemOf(snakeKeys(rest), {
@@ -131,7 +132,7 @@ export const contactsCommand = (messenger) => {
                     .filter((chat) => chat.provider === messenger.provider)
                     .map((chat) => nextStep("messages.sync", { args: { chat: chat.chatId } }))
                 : [],
-            ...(hasMore ? { meta: { truncated: true } } : {}),
+            meta: { ...window.meta, ...(hasMore ? { truncated: true } : {}) },
         }));
         if (hasMore)
             context.renderer.note("cut at --limit; a larger one shows more");

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

@@ -1,4 +1,4 @@
-import type { Missing, NextStep } from "@wirecat/cli-base/standards";
+import type { Meta, Missing, NextStep } from "@wirecat/cli-base/standards";
 import type { Message } from "../../domain/models.js";
 import { type MessengerTraits } from "../../ports/traits.js";
 import type { ChatReadiness, FoundConversations, Refreshed } from "../../services/embeddings.js";
@@ -11,7 +11,7 @@ export declare const readinessGaps: ({ meaning, model, readiness, refreshed, cov
     missing: Missing[];
 };
 /** `search conversations` and `conversations related`, CLI and MCP alike. */
-export declare const foundConversations: (command: string, found: Readiness & Pick<FoundConversations, "hits" | "accounts">, limit: number, messenger: Syncing, chat?: string) => import("../envelope.js").ListBody<unknown>;
+export declare const foundConversations: (command: string, found: Readiness & Pick<FoundConversations, "hits" | "accounts">, limit: number, messenger: Syncing, chat?: string, meta?: Partial<Meta>) => import("../envelope.js").ListBody<unknown>;
 /** `conversations status`: each built chat with the model it was measured by; group chats never built are missing. */
 export declare const readinessList: ({ model, chats, unbuiltGroups, }: {
     model: string;

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

@@ -53,12 +53,15 @@ export const readinessGaps = ({ meaning, model, readiness, refreshed, coverage }
     return { next, missing };
 };
 /** `search conversations` and `conversations related`, CLI and MCP alike. */
-export const foundConversations = (command, found, limit, messenger, chat) => listOf(command, {
+export const foundConversations = (command, found, limit, messenger, chat, meta = {}) => listOf(command, {
     items: found.hits.map((hit) => snakeKeys(hit)),
     limit,
     has_more: false,
     ...readinessGaps(found, messenger, chat),
-    ...(found.accounts ? { meta: { accounts: found.accounts.map((one) => `${one.provider}:${one.account}`) } } : {}),
+    meta: {
+        ...meta,
+        ...(found.accounts ? { accounts: found.accounts.map((one) => `${one.provider}:${one.account}`) } : {}),
+    },
 });
 /** `conversations status`: each built chat with the model it was measured by; group chats never built are missing. */
 export const readinessList = ({ model, chats, unbuiltGroups, }) => listOf("conversations status", {

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

@@ -9,7 +9,7 @@ import { renderMessages } from "../../render/messages.js";
 import { BATCH_SIZE, CONVERSATION_QUERY } from "../../services/conversations.js";
 import { REFRESH_BOUNDS, } from "../../services/embeddings.js";
 import { servicesFor, storedDeps } from "../../services/index.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { analysisChoice } from "../analysis-choice.js";
 import { destroysNothing, LOCAL_READ, LOCAL_WRITE, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, } from "../effects.js";
 import { embeddingChoice, refuseRemoteQuery } from "../embedding-choice.js";
@@ -531,6 +531,10 @@ export const conversationsSearchCommand = (messenger) => syncOptions(boundOption
         refuseLocalWrite(context, messenger.app.command, EMBED_KEY);
     }
     const { limit } = context.settings;
+    const window = dateWindow({
+        ...(since === undefined ? {} : { sinceTime: since }),
+        ...(options.timezone === undefined ? {} : { zone: options.timezone }),
+    });
     const { found, refreshed } = await context.withServices(async (services) => {
         const syncing = syncRequest(this, context);
         const found = await services.embeddings.search(query, {
@@ -551,14 +555,14 @@ export const conversationsSearchCommand = (messenger) => syncOptions(boundOption
             ...(options.timezone === undefined ? {} : { timezone: options.timezone }),
             ...(chat === undefined ? {} : { chat }),
             model,
-            ...(since === undefined ? {} : { since: new Date(momentOf(since, "--since-time")).toISOString() }),
+            ...(window.since === undefined ? {} : { since: new Date(window.since).toISOString() }),
         });
         return { found, refreshed: found.prepared };
     });
     if (refreshed)
         for (const note of leftNotes(refreshed, rootOf(this)))
             context.renderer.note(note);
-    renderAnswer(this, context, foundConversations("search conversations", found, limit, messenger, chat), () => found.hits.map((hit) => `${hitLine(hit)}\n`).join(""));
+    renderAnswer(this, context, foundConversations("search conversations", found, limit, messenger, chat, window.meta), () => found.hits.map((hit) => `${hitLine(hit)}\n`).join(""));
     if (found.hits.length === 0 && context.format === "pretty")
         context.renderer.note(found.meaning === "unavailable"
             ? "nothing matches in words"

package/dist/cli/messenger/inbox.js

@@ -51,7 +51,7 @@ export const inboxCommand = (messenger) => annotate(new Command("inbox"), {
     const { app } = messenger;
     const { settings, renderer, format, env } = context;
     const kinds = kind === undefined ? undefined : kindsOf(kind);
-    const { since } = catchUpQuery(query, INBOX_QUERY, "inbox");
+    const { since, meta } = catchUpQuery(query, INBOX_QUERY, "inbox");
     if (fresh && since !== undefined)
         throw new CliError("validation_error", "--new keeps its own point — not with a date in the query");
     const saved = fresh && since === undefined
@@ -83,7 +83,7 @@ export const inboxCommand = (messenger) => annotate(new Command("inbox"), {
         renderer.note(`marked ${marked.length} chat(s) read up to the newest message shown`);
     if (inbox.partial && format === "pretty")
         renderer.warn(PARTIAL_NOTE);
-    const answer = inboxAnswer(inbox, hearing, reader, transcribe === true);
+    const answer = inboxAnswer(inbox, hearing, reader, transcribe === true, meta);
     renderAnswer(this, context, answer, () => {
         if (answer.items.length === 0) {
             renderer.note(inbox.mode === "unread" ? "nothing unread" : `nothing new since ${inbox.since}`);

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

@@ -6,7 +6,7 @@ import { replyRenderer } from "../../replies/rendering.js";
 import { audienceWarnings, readReplies, repliesPathFor } from "../../replies/rules.js";
 import { paused, readRepliesState, repliesStatePathFor, writeRepliesState } from "../../replies/state.js";
 import { levelFor } from "../../sends/permissions.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { grantsAuthority, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { messengerContext } from "./context.js";
@@ -37,7 +37,8 @@ export const repliesCommand = (messenger) => {
             throw new CliError("validation_error", "--ai calls a model and cannot be combined with --offline");
         if (ai && levelFor(settings.permissions, "messages.list").level === "deny")
             throw new CliError("permission_error", "this profile denies reading messages — no stored data was sent to a reply model");
-        const since = momentOf(sinceTime ?? `${DRY_RUN_DAYS}d`, "--since-time");
+        const window = dateWindow({ sinceTime: sinceTime ?? `${DRY_RUN_DAYS}d` });
+        const since = window.since;
         const path = repliesPathFor(messenger.app, settings.profile, env);
         const { rules, audience } = readReplies(path, messenger.provider);
         if (rules.length === 0) {
@@ -81,7 +82,7 @@ export const repliesCommand = (messenger) => {
                 .sort(([, a], [, b]) => b - a)
                 .map(([why, count]) => `  passed over ${count}: ${why}`),
         ]);
-        renderAnswer(this, context, itemOf(answer), () => `${lines.join("\n")}\n`);
+        renderAnswer(this, context, itemOf(answer, { meta: window.meta }), () => `${lines.join("\n")}\n`);
     });
     const switched = (on) => async function () {
         const context = messengerContext(this, messenger);

package/dist/cli/messenger/review.js

@@ -45,7 +45,7 @@ export const reviewCommand = (messenger) => annotate(new Command("review"), {
     const hearWith = modelWith(options.transcribe, options.model);
     const context = messengerContext(this, messenger);
     const { settings, renderer, format, env } = context;
-    const { since: from, chat } = catchUpQuery(query, REVIEW_QUERY, "review");
+    const { since: from, chat, meta } = catchUpQuery(query, REVIEW_QUERY, "review");
     if (options.new && (from !== undefined || options.unanswered !== undefined)) {
         // An open question stays open: moving past it would drop it from the next review.
         throw new CliError("validation_error", "--new keeps its own point — not with a date or --unanswered");
@@ -96,6 +96,7 @@ export const reviewCommand = (messenger) => annotate(new Command("review"), {
         transcribe,
         fresh: saved !== undefined,
         ...(chat === undefined ? {} : { chat }),
+        ...(meta === undefined ? {} : { meta }),
     }), () => {
         const read = found.chats
             .flatMap((one) => one.messages.map((message) => ({ ...message, chatTitle: one.title })))

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

@@ -67,7 +67,7 @@ export declare const chartAnswer: (chart: ChartData, file?: {
 /** 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. */
-export declare const chatStatsAnswer: (stats: ChatStats, account: AccountKey) => ItemBody<Of<"chat_stats">>;
+export declare const chatStatsAnswer: (stats: ChatStats, account: AccountKey, meta?: Partial<Meta>) => ItemBody<Of<"chat_stats">>;
 /** Said where the store has kept no join, leave or other chat event for the chat: a 0 would read as nobody joined. */
 export declare const MEMBERS_UNRECORDED = "joins and leaves are not recorded for this chat yet, so they are not counted";
 /** `stats tasks show`, CLI and MCP alike. */

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

@@ -167,7 +167,7 @@ export const adminAnswer = (found) => {
         rows,
     }, {
         next: drilldownSteps(top?.drilldown, top?.drilldown.arguments.component, top?.message ?? (top?.id.startsWith("msg:") ? top.id : undefined)),
-        ...truncated(found.hasMore),
+        meta: { ...found.timeMeta, ...(found.hasMore ? { truncated: true } : {}) },
     });
 };
 const cohortRow = (row) => ({
@@ -221,7 +221,7 @@ export const retentionAnswer = (found) => {
         rows: found.items.map(cohortRow),
     }, {
         next: drilldownSteps(top?.drilldown, top?.drilldown.arguments.component),
-        ...truncated(found.hasMore),
+        meta: { ...found.timeMeta, ...(found.hasMore ? { truncated: true } : {}) },
     });
 };
 const evidenceMessage = (hit) => ({
@@ -335,7 +335,7 @@ export const refuseJsonl = (format) => {
         });
 };
 /** `stats chats show`, CLI and MCP alike; a chat the store does not hold whole names the sync that fills it. */
-export const chatStatsAnswer = (stats, account) => {
+export const chatStatsAnswer = (stats, account, meta) => {
     const { chatId, completeness, topPosts, questions, memberCounts, members, series, fetch } = stats;
     const item = defined({
         chat: chatRef(account, chatId),
@@ -405,6 +405,7 @@ export const chatStatsAnswer = (stats, account) => {
         ...(completeness.state === "complete" || fetch === undefined
             ? {}
             : { next: [nextStep("messages.sync", { args: { chat: chatId } })] }),
+        ...(meta ? { meta } : {}),
     });
 };
 /** Said where the store has kept no join, leave or other chat event for the chat: a 0 would read as nobody joined. */

package/dist/cli/runs/search.d.ts

@@ -42,6 +42,13 @@ export declare const searchRuns: (dir: string, { query, status, errorCode, opera
     page: number;
     limit: number;
     hasMore: boolean;
+    meta: {
+        timezone?: string;
+        window?: {
+            since?: string;
+            until?: string;
+        };
+    };
 };
 /** A page of `searchRuns` in the list envelope; `args` are the search's own, so `page.next` reruns it. */
 export declare const runsFound: (found: ReturnType<typeof searchRuns>, args: Record<string, unknown>) => import("../envelope.js").ListBody<unknown>;

package/dist/cli/runs/search.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { findRun, listRuns, readEvents } from "../../runs/run.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { listOf, snakeKeys } from "../envelope.js";
 const FIELDS = [
     "event",
@@ -35,7 +35,8 @@ const safeEvent = (event) => Object.fromEntries(FIELDS.flatMap((name) => {
 export const searchRuns = (dir, { query = "", status, errorCode, operation, profile, since, limit = 20, page = 1 } = {}) => {
     if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100 || !Number.isSafeInteger(page) || page < 1)
         throw new CliError("validation_error", "run search uses a limit from 1 to 100 and a positive page");
-    const from = since === undefined ? undefined : momentOf(since, "--since-time");
+    const window = dateWindow(since === undefined ? {} : { sinceTime: since });
+    const from = window.since;
     if (from !== undefined && !Number.isFinite(from))
         throw new CliError("validation_error", "--since-time must be a valid date or ISO timestamp");
     const needle = query.toLowerCase();
@@ -100,7 +101,13 @@ export const searchRuns = (dir, { query = "", status, errorCode, operation, prof
         if (matches.length > offset + limit)
             break;
     }
-    return { items: matches.slice(offset, offset + limit), page, limit, hasMore: matches.length > offset + limit };
+    return {
+        items: matches.slice(offset, offset + limit),
+        page,
+        limit,
+        hasMore: matches.length > offset + limit,
+        meta: window.meta,
+    };
 };
 /** A page of `searchRuns` in the list envelope; `args` are the search's own, so `page.next` reruns it. */
 export const runsFound = (found, args) => listOf("runs search", {
@@ -109,4 +116,5 @@ export const runsFound = (found, args) => listOf("runs search", {
     has_more: found.hasMore,
     page: found.page,
     args: Object.fromEntries(Object.entries(args).filter(([name, value]) => value !== undefined && name !== "page")),
+    meta: found.meta,
 });

package/dist/meetings/answers.d.ts

@@ -1,4 +1,4 @@
-import { type ItemEnvelope, type ListEnvelope } from "@wirecat/cli-base/standards";
+import { type ItemEnvelope, type ListEnvelope, type Meta } from "@wirecat/cli-base/standards";
 import * as v from "valibot";
 import { type MeetingOwner } from "./item.js";
 import type { Summary, Transcript, TranscriptRow } from "./model.js";
@@ -160,4 +160,6 @@ export declare const MEETING_STEPS: ({
 export declare const meetingHitItem: (hit: SearchHit & {
     ref: string;
 }) => MeetingHitItem;
-export declare const meetingHitsList: (found: MeetingSearchPage, limit: number, command?: string, args?: Record<string, unknown>) => MeetingListBody<MeetingHitItem>;
+export declare const meetingHitsList: (found: MeetingSearchPage, limit: number, command?: string, args?: Record<string, unknown>, meta?: Partial<Meta>) => MeetingListBody<MeetingHitItem> & {
+    meta?: Partial<Meta>;
+};

package/dist/meetings/answers.js

@@ -201,7 +201,7 @@ export const meetingHitItem = (hit) => ({
             },
         }),
 });
-export const meetingHitsList = (found, limit, command = "search meetings", args = {}) => {
+export const meetingHitsList = (found, limit, command = "search meetings", args = {}, meta = {}) => {
     const items = found.items.map(meetingHitItem);
     const cursor = found.hasMore && found.nextCursor !== null ? found.nextCursor : undefined;
     const pending = found.coverage.indexing === "pending";
@@ -238,5 +238,6 @@ export const meetingHitsList = (found, limit, command = "search meetings", args
                 ],
             }
             : {}),
+        ...(Object.keys(meta).length === 0 ? {} : { meta }),
     };
 };

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

@@ -17,4 +17,4 @@ export declare const addMeetingCommands: (program: Command, deps: MeetingCommand
 export { addMeetingPassageCommand, createMeetingPassageCommand, type MeetingPassageFlags, meetingPassageRequest, } from "./passage.js";
 export { addMeetingProjectEvidenceCommand } from "./project-evidence.js";
 export { queryWordsAfterOptions } from "./query-options.js";
-export { addMeetingSearchCommand, createMeetingSearchCommand, type MeetingHitSearch, type MeetingHitSearchOptions, type MeetingSearchFlags, meetingHitSearchRequest, meetingSearchArguments, validateMeetingHitSearch, } from "./search.js";
+export { addMeetingSearchCommand, createMeetingSearchCommand, type MeetingHitSearch, type MeetingHitSearchOptions, type MeetingSearchFlags, meetingHitSearchRequest, meetingSearchArguments, meetingSearchMeta, validateMeetingHitSearch, } from "./search.js";

package/dist/meetings/cli/index.js

@@ -144,4 +144,4 @@ export const addMeetingCommands = (program, deps) => {
 export { addMeetingPassageCommand, createMeetingPassageCommand, meetingPassageRequest, } from "./passage.js";
 export { addMeetingProjectEvidenceCommand } from "./project-evidence.js";
 export { queryWordsAfterOptions } from "./query-options.js";
-export { addMeetingSearchCommand, createMeetingSearchCommand, meetingHitSearchRequest, meetingSearchArguments, validateMeetingHitSearch, } from "./search.js";
+export { addMeetingSearchCommand, createMeetingSearchCommand, meetingHitSearchRequest, meetingSearchArguments, meetingSearchMeta, validateMeetingHitSearch, } from "./search.js";

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

@@ -1,3 +1,4 @@
+import type { Meta } from "@wirecat/cli-base/standards";
 import { Command } from "commander";
 import type { MeetingSearchPage } from "../search-store.js";
 import { type MeetingHitSearchOptions } from "../search-validation.js";
@@ -13,6 +14,8 @@ export interface MeetingSearchFlags {
     topic?: string;
     sinceTime?: number;
     untilTime?: number;
+    /** The zone a date or time without one was read in; the parser sets it, since the typed text is gone after. */
+    timesReadIn?: string;
     limit?: number;
     cursor?: string;
     maxReadBytes?: number;
@@ -23,6 +26,8 @@ export declare const createMeetingSearchCommand: (program: Command) => Command;
 export declare const meetingHitSearchRequest: (query: string, options: MeetingSearchFlags, signal?: AbortSignal) => MeetingHitSearchOptions;
 /** Parsed dates must become ISO values again so the CLI can replay its own continuation. */
 export declare const meetingSearchArguments: (query: string, options: MeetingSearchFlags) => Record<string, unknown>;
+/** What `meta` says about the dates: the zone one without its own was read in, and the window in UTC. */
+export declare const meetingSearchMeta: (options: MeetingSearchFlags) => Pick<Meta, "timezone" | "window">;
 export declare const addMeetingSearchCommand: (program: Command, deps: {
     search: (query: string, request: MeetingHitSearchOptions, options: MeetingSearchFlags & Record<string, unknown>) => Promise<MeetingSearchPage>;
     signal: () => AbortSignal | undefined;

package/dist/meetings/cli/search.js

@@ -5,13 +5,19 @@ import { Command } from "commander";
 import { meetingHitsList } from "../answers.js";
 import { validateMeetingHitSearch } from "../search-validation.js";
 export { validateMeetingHitSearch } from "../search-validation.js";
-const moment = (flag, end) => (value) => {
+const ZONED = /(?:Z|[+-]\d{2}:?\d{2})$/i;
+const moment = (flag, end, readIn) => (value) => {
+    const zone = timezoneOf();
+    let time;
     try {
-        return zonedMoment(value, timezoneOf(), { start: 0, end: value.length }, { end });
+        time = zonedMoment(value, zone, { start: 0, end: value.length }, { end });
     }
     catch {
         throw new CliError("validation_error", `${flag} takes an ISO date, or a time with or without an offset`);
     }
+    if (!ZONED.test(value.trim()))
+        readIn(zone);
+    return time;
 };
 const integer = (value) => {
     if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(Number(value)))
@@ -25,6 +31,7 @@ export const createMeetingSearchCommand = (program) => {
         search = new Command("search").description("search the stored resources");
         program.addCommand(search);
     }
+    const readIn = (zone) => command.setOptionValue("timesReadIn", zone);
     const command = search
         .command("meetings")
         .description("find words in stored meetings, indexing new ones first")
@@ -37,8 +44,8 @@ export const createMeetingSearchCommand = (program) => {
         .option("--project <name>", "meetings confirmed in this project, by name, key or alias")
         .option("--tag <name>", "meetings with this tag, by name or alias")
         .option("--topic <name>", "meetings with this topic, by name or alias")
-        .option("--since-time <time>", "meetings starting at or after this ISO 8601 date or time", moment("--since-time", false))
-        .option("--until-time <time>", "meetings starting at or before this ISO 8601 date or time; a date alone covers that whole local day", moment("--until-time", true))
+        .option("--since-time <time>", "meetings starting at or after this ISO 8601 date or time", moment("--since-time", false, readIn))
+        .option("--until-time <time>", "meetings starting at or before this ISO 8601 date or time; a date alone covers that whole local day", moment("--until-time", true, readIn))
         .option("--limit <n>", "how many hits, 1 through 1000 (default 100)", integer)
         .option("--cursor <cursor>", "continue from the previous page's page.next_cursor, with the same query and filters")
         .option("--max-read-bytes <bytes>", "most stored bytes to read, 1 through 67108864 (default 4194304)", integer);
@@ -86,7 +93,18 @@ export const meetingSearchArguments = (query, options) => Object.fromEntries(Obj
     until_time: options.untilTime === undefined ? undefined : new Date(options.untilTime).toISOString(),
     max_read_bytes: options.maxReadBytes ?? 4194304,
 }).filter(([, value]) => value !== undefined));
+/** What `meta` says about the dates: the zone one without its own was read in, and the window in UTC. */
+export const meetingSearchMeta = (options) => {
+    const window = {
+        ...(options.sinceTime === undefined ? {} : { since: new Date(options.sinceTime).toISOString() }),
+        ...(options.untilTime === undefined ? {} : { until: new Date(options.untilTime).toISOString() }),
+    };
+    return {
+        ...(options.timesReadIn === undefined ? {} : { timezone: options.timesReadIn }),
+        ...(Object.keys(window).length === 0 ? {} : { window }),
+    };
+};
 export const addMeetingSearchCommand = (program, deps) => createMeetingSearchCommand(program).action(async (query, options) => {
     const request = meetingHitSearchRequest(query, options, deps.signal());
-    deps.output(meetingHitsList(await deps.search(query, request, options), request.limit ?? 100, "search meetings", meetingSearchArguments(query, options)));
+    deps.output(meetingHitsList(await deps.search(query, request, options), request.limit ?? 100, "search meetings", meetingSearchArguments(query, options), meetingSearchMeta(options)));
 });

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

@@ -150,7 +150,9 @@ export declare const callMeetingSearchTool: (search: MeetingHitSearch, input: un
             started_at: string | null;
             url: string | null;
         } | undefined;
-    }>;
+    }> & {
+        meta?: Partial<import("@wirecat/cli-base/standards").Meta>;
+    };
 } & {
     isError?: boolean;
 })>;

package/dist/meetings/mcp/search.js

@@ -60,10 +60,11 @@ export const callMeetingSearchTool = async (search, input, signal, failure = {})
         const query = args.query;
         validateMeetingHitSearch(query, options);
         signal?.throwIfAborted();
-        const result = meetingHitsList(await search(query, options), options.limit ?? 100, "search meetings", {
-            ...args,
-            max_read_bytes: options.maxReadBytes ?? 4194304,
-        });
+        const window = {
+            ...(options.since === undefined ? {} : { since: new Date(options.since).toISOString() }),
+            ...(options.until === undefined ? {} : { until: new Date(options.until).toISOString() }),
+        };
+        const result = meetingHitsList(await search(query, options), options.limit ?? 100, "search meetings", { ...args, max_read_bytes: options.maxReadBytes ?? 4194304 }, Object.keys(window).length === 0 ? {} : { window });
         signal?.throwIfAborted();
         return agentResult({
             content: [{ type: "text", text: JSON.stringify(result) }],

package/dist/services/admin-statistics.d.ts

@@ -2,6 +2,7 @@ import type { AdminOptions, AdminReport } from "../domain/admin-statistics.js";
 import type { AdminStoreResult, MessageStore } from "../store/store.js";
 import type { ServiceDeps } from "./deps.js";
 import type { SearchQuery } from "./messages.js";
+import { type DateWindow } from "./moment.js";
 import { type RankingSelection } from "./rankings-selection.js";
 export type AdminQuery = SearchQuery & {
     answerers?: string[];
@@ -28,6 +29,8 @@ export interface AdminSelection {
 }
 export interface AdminFound extends AdminStoreResult {
     report: AdminReport;
+    /** How the typed join dates were read, for the answer's `meta`. */
+    timeMeta?: DateWindow["meta"];
     detectorVersion: 1;
     items: (AdminStoreResult["items"][number] & {
         drilldown: {

package/dist/services/admin-statistics.js

@@ -2,7 +2,7 @@ import { CliError, singleLine } from "@wirecat/cli-base";
 import { parseLocator } from "../domain/locator.js";
 import { isId, pickPerson } from "../resolve.js";
 import { prepareLucene, stemExecution } from "./messages-search.js";
-import { momentOf } from "./moment.js";
+import { dateWindow } from "./moment.js";
 import { rankingSelection, readRankingSelection } from "./rankings-selection.js";
 import { searchRecordOf } from "./search-record.js";
 function invalid(message) {
@@ -205,6 +205,12 @@ export const adminStatisticsService = (deps) => ({
         if (pinned &&
             (query.source || query.ast || query.exact || (query.timezone && query.timezone !== prepared.timezone)))
             invalid("a saved report keeps its resolved query, accounts and timezone");
+        const window = dateWindow({
+            ...(query.sinceTime ? { sinceTime: query.sinceTime } : {}),
+            ...(query.untilTime ? { untilTime: query.untilTime } : {}),
+            zone: prepared.timezone,
+            now: cutoff,
+        });
         const options = {
             report,
             cutoff,
@@ -212,12 +218,8 @@ export const adminStatisticsService = (deps) => ({
                 ? pinned.options.olderThan
                 : duration(query.olderThan ?? "24h", "--older-than"),
             within: query.within === undefined && pinned ? pinned.options.within : duration(query.within ?? "7d", "--within"),
-            joinSince: query.sinceTime
-                ? momentOf(query.sinceTime, "--since-time", cutoff, { zone: prepared.timezone })
-                : (pinned?.options.joinSince ?? cutoff - 30 * 86_400_000),
-            joinUntil: query.untilTime
-                ? momentOf(query.untilTime, "--until-time", cutoff, { zone: prepared.timezone, end: true })
-                : (pinned?.options.joinUntil ?? cutoff),
+            joinSince: window.since ?? pinned?.options.joinSince ?? cutoff - 30 * 86_400_000,
+            joinUntil: window.until ?? pinned?.options.joinUntil ?? cutoff,
             minViews: count(query.minViews ?? pinned?.options.minViews ?? 1, "--min-views"),
             maxReplies: count(query.maxReplies ?? pinned?.options.maxReplies ?? 0, "--max-replies"),
             answerers: query.answerers === undefined && pinned
@@ -252,6 +254,7 @@ export const adminStatisticsService = (deps) => ({
         return {
             ...result,
             report,
+            timeMeta: window.meta,
             detectorVersion: 1,
             items: result.items.map((original) => {
                 const identityKnown = known.has(JSON.stringify([original.account.provider, original.account.account, original.id]));

package/dist/services/retention.d.ts

@@ -75,6 +75,13 @@ export declare const retentionService: (deps: ServiceDeps) => {
         }[];
         account: import("../store/types.js").AccountKey;
         report: "retention";
+        timeMeta: {
+            timezone?: string;
+            window?: {
+                since?: string;
+                until?: string;
+            };
+        };
     }>;
     evidence: (target: "messages" | "contacts", reference: string, selection: unknown, query: {
         component: string;

package/dist/services/retention.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { timezoneOf } from "@wirecat/cli-base/query";
 import { storedChatId } from "./message-resolution.js";
-import { momentOf } from "./moment.js";
+import { dateWindow } from "./moment.js";
 export const observationDuration = (text, flag) => {
     const match = /^(\d+(?:\.\d+)?)([smhdw])$/.exec(text);
     const units = { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 };
@@ -14,11 +14,15 @@ export const retentionService = (deps) => ({
     report: async (chat, query = {}) => {
         const cutoff = Date.now();
         const zone = timezoneOf(query.timezone);
+        const window = dateWindow({
+            ...(query.sinceTime === undefined ? {} : { sinceTime: query.sinceTime }),
+            ...(query.untilTime === undefined ? {} : { untilTime: query.untilTime }),
+            zone,
+            now: cutoff,
+        });
         const options = {
-            since: query.sinceTime === undefined
-                ? cutoff - 90 * 86_400_000
-                : momentOf(query.sinceTime, "--since-time", cutoff, { zone }),
-            until: query.untilTime === undefined ? cutoff : momentOf(query.untilTime, "--until-time", cutoff, { zone, end: true }),
+            since: window.since ?? cutoff - 90 * 86_400_000,
+            until: window.until ?? cutoff,
             cutoff,
             checkpoints: (query.checkpoints ?? "1d,7d,30d")
                 .split(",")
@@ -46,6 +50,7 @@ export const retentionService = (deps) => ({
             })),
             account,
             report: "retention",
+            timeMeta: window.meta,
         };
     },
     evidence: async (target, reference, selection, query) => {

package/package.json

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