@wirecat/cli-core 0.377.0 → 0.379.0

package/dist/meetings/answers.d.ts

@@ -18,7 +18,7 @@ export declare const meetingHit: v.StrictObjectSchema<{
     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>;
-        readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>;
@@ -29,8 +29,8 @@ export declare const meetingTranscript: v.StrictObjectSchema<{
     readonly source: v.StringSchema<undefined>;
     readonly language: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     /** When a newer transcript of the same source replaced it; `meetings transcript --history` shows those too. */
-    readonly superseded_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly superseded_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     readonly lines: v.ArraySchema<v.StrictObjectSchema<{
         readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly offset_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -53,8 +53,8 @@ export declare const meetingSummary: v.StrictObjectSchema<{
     readonly next_steps: v.ArraySchema<v.StringSchema<undefined>, undefined>;
     readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
 }, undefined>;
 /** `meetings show`: the meeting with who took part, what was said in its chat, and what it holds. */
 export declare const meetingDetails: v.StrictObjectSchema<{
@@ -66,13 +66,13 @@ export declare const meetingDetails: v.StrictObjectSchema<{
     readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly location: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     /** The stored event and series it belongs to, as `meetings_list` takes them. */
     readonly event_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly series_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -81,8 +81,8 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly email: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly joined_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-        readonly left_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly joined_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+        readonly left_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     }, undefined>, undefined>;
     readonly transcripts: v.ArraySchema<v.StrictObjectSchema<{
@@ -92,7 +92,7 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly lines_count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly chat: v.ArraySchema<v.StrictObjectSchema<{
-        readonly sent_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+        readonly sent_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
         readonly sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly recipient: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly text: v.StringSchema<undefined>;
@@ -110,8 +110,8 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly next_steps: v.ArraySchema<v.StringSchema<undefined>, undefined>;
         readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-        readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+        readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+        readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     }, undefined>, undefined>;
     readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
         readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/meetings/cli/index.js

@@ -1,5 +1,5 @@
 import { annotate } from "@wirecat/cli-base/commands";
-import { defineQuery, fieldsHelp } from "@wirecat/cli-base/query";
+import { defineQuery, fieldsHelp, timezoneOf, zonedMoment } from "@wirecat/cli-base/query";
 import { InvalidArgumentError, Option } from "commander";
 import { exportMeeting } from "../export.js";
 import { importFiles } from "../import.js";
@@ -19,9 +19,12 @@ const lookbackDays = (text) => {
     return Number(text);
 };
 const date = (text) => {
-    if (!Number.isFinite(Date.parse(text)))
-        throw new InvalidArgumentError("expected an ISO date or timestamp");
-    return Date.parse(text);
+    try {
+        return zonedMoment(text, timezoneOf(), { start: 0, end: text.length });
+    }
+    catch {
+        throw new InvalidArgumentError("expected an ISO date, or a time with or without an offset");
+    }
 };
 const LOCAL_READ = { remote: "none", local: "read" };
 const LOCAL_WRITE = { remote: "none", local: "write" };

package/dist/meetings/cli/search.js

@@ -1,25 +1,23 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
+import { timezoneOf, zonedMoment } from "@wirecat/cli-base/query";
 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) => {
+    try {
+        return zonedMoment(value, timezoneOf(), { 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`);
+    }
+};
 const integer = (value) => {
     if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(Number(value)))
         throw new CliError("validation_error", "expected a positive safe integer");
     return Number(value);
 };
-const timestamp = (value) => {
-    const parsed = Date.parse(value);
-    const date = value.slice(0, 10);
-    const day = Date.parse(`${date}T00:00:00Z`);
-    if (!/^\d{4}-\d{2}-\d{2}(?:T.+(?:Z|[+-]\d{2}:\d{2}))?$/.test(value) ||
-        !Number.isFinite(parsed) ||
-        !Number.isFinite(day) ||
-        new Date(day).toISOString().slice(0, 10) !== date)
-        throw new CliError("validation_error", "meeting search dates require a real ISO date or timestamp with offset");
-    return parsed;
-};
 /** Shared grammar without an action: a host with other source reports supplies their transport routing. */
 export const createMeetingSearchCommand = (program) => {
     let search = program.commands.find((command) => command.name() === "search");
@@ -39,8 +37,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", timestamp)
-        .option("--until-time <time>", "meetings starting at or before this ISO 8601 date or time", timestamp)
+        .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("--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);

package/dist/meetings/item.d.ts

@@ -11,13 +11,13 @@ export declare const meeting: v.StrictObjectSchema<{
     readonly location: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     /** The link that joins it. */
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
 }, undefined>;
 export type MeetingItem = v.InferOutput<typeof meeting>;
 /** Which provider and account a stored meeting account is, as `MeetingStore.account` answers it. */

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

@@ -27,7 +27,7 @@ export declare const meetingProjectEvidence: v.StrictObjectSchema<{
         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>;
-            readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+            readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
@@ -40,8 +40,8 @@ export declare const meetingProjectEvidence: v.StrictObjectSchema<{
         readonly tag_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly event_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly series_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
-        readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-        readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+        readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     }, undefined>;
     readonly limits: v.StrictObjectSchema<{
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/services/admin-statistics.js

@@ -213,10 +213,10 @@ export const adminStatisticsService = (deps) => ({
                 : 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)
+                ? 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)
+                ? momentOf(query.untilTime, "--until-time", cutoff, { zone: prepared.timezone, end: true })
                 : (pinned?.options.joinUntil ?? cutoff),
             minViews: count(query.minViews ?? pinned?.options.minViews ?? 1, "--min-views"),
             maxReplies: count(query.maxReplies ?? pinned?.options.maxReplies ?? 0, "--max-replies"),

package/dist/services/context-evidence.js

@@ -23,6 +23,7 @@ export const createContextEvidenceReader = (port, allowed, limits) => {
                 source: Object.freeze({ ...source }),
                 ...(validated.query === undefined ? {} : { query: validated.query }),
                 ...(validated.chat === undefined ? {} : { chat: validated.chat }),
+                ...(validated.senders === undefined ? {} : { senders: Object.freeze([...validated.senders]) }),
                 after: validated.after,
                 before: validated.before,
                 limit: validated.limit,

package/dist/services/index.d.ts

@@ -9,7 +9,7 @@ export type { ProjectNeighbour, ProjectNeighbourReader } from "./project-gatheri
 export { documentPassage, storedMessageNeighbours, storedNeighbours } from "./project-gathering-around.js";
 export type { EvidenceMention, EvidenceMentions } from "./project-gathering-mentions.js";
 export { findEvidenceMentions } from "./project-gathering-mentions.js";
-export type { ProjectFetchState, ProjectGatheringBudgets, ProjectGatheringRequest, ProjectLane, ProjectLaneKind, ProjectLinkedChat, ProjectUnitState, } from "./project-gathering-request.js";
+export type { ProjectFetchState, ProjectGatheringBudgets, ProjectGatheringRequest, ProjectLane, ProjectLaneKind, ProjectLinkedChat, ProjectPerson, ProjectSender, ProjectUnitState, } from "./project-gathering-request.js";
 import { type AccountService } from "./account.js";
 import { type AdminService } from "./admin.js";
 import { type AdminStatisticsService } from "./admin-statistics.js";

package/dist/services/meeting-communications-selection.d.ts

@@ -16,6 +16,7 @@ export declare const captureCommunicationSelections: (port: MeetingCommunication
             source: import("./context-evidence.js").ContextSource;
             query: string | undefined;
             chat: string | undefined;
+            senders: string[] | undefined;
             after: number;
             before: number;
             limit: number;

package/dist/services/messages-archive-search.js

@@ -65,7 +65,7 @@ const searchPage = async (store, account, request, messenger) => {
         throw new CliError("validation_error", "discovery searches the local archive; use backend archive");
     await topUp(store);
     const found = request.discover
-        ? await searchDiscovery(store, account, request, messenger)
+        ? await searchDiscovery(store, account, { ...request, thread: undefined }, messenger)
         : await searchLucene(store, account, request, messenger);
     return withThreads(store, found, request);
 };

package/dist/services/moment.d.ts

@@ -1,12 +1,14 @@
+import { type MomentZone } from "../domain/moment.js";
+export type { MomentZone };
 /** Shaped like a moment `momentOf` reads, whether or not it is a valid one. */
 export declare const isMoment: (reference: string) => boolean;
 /**
  * `--since` as a moment: ISO 8601, or `30m`, `2h`, `1d` ago. Unlike max-cli, never a message id —
  * a MAX id carries its time, and a Telegram id is only a counter within one chat.
  */
-export declare const momentOf: (reference: string, flag?: string, now?: number) => number;
+export declare const momentOf: (reference: string, flag?: string, now?: number, at?: MomentZone) => number;
 /**
  * A time ahead, for a due date or the next check: ISO 8601, or `30m`, `2h`, `3d` from now. `none`
  * is not a time; a caller that clears a date checks for it first.
  */
-export declare const aheadOf: (reference: string, flag: string, now?: number) => number;
+export declare const aheadOf: (reference: string, flag: string, now?: number, at?: MomentZone) => number;

package/dist/services/moment.js

@@ -1,4 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
+import { calendarMoment } from "../domain/moment.js";
 const AGO = /^(\d+)(m|h|d)$/;
 const AGO_MS = { m: 60_000, h: 3_600_000, d: 86_400_000 };
 const DATE = /^\d{4}-\d{2}-\d{2}/;
@@ -11,11 +12,15 @@ export const isMoment = (reference) => {
  * `--since` as a moment: ISO 8601, or `30m`, `2h`, `1d` ago. Unlike max-cli, never a message id —
  * a MAX id carries its time, and a Telegram id is only a counter within one chat.
  */
-export const momentOf = (reference, flag = "--since", now = Date.now()) => {
+export const momentOf = (reference, flag = "--since", now = Date.now(), at = {}) => {
     const wanted = reference.trim();
     const [, amount, unit] = AGO.exec(wanted) ?? [];
     // By shape: `Date.parse("12345")` is the year 12345, so a message id would pass as a date.
-    const time = amount && unit ? now - Number(amount) * (AGO_MS[unit] ?? 0) : DATE.test(wanted) ? Date.parse(wanted) : Number.NaN;
+    const time = amount && unit
+        ? now - Number(amount) * (AGO_MS[unit] ?? 0)
+        : DATE.test(wanted)
+            ? calendarMoment(wanted, flag, at)
+            : Number.NaN;
     if (Number.isNaN(time)) {
         throw new CliError("validation_error", `${flag} takes an ISO 8601 time or 30m, 2h, 1d ago — not "${wanted}"`);
     }
@@ -25,10 +30,14 @@ export const momentOf = (reference, flag = "--since", now = Date.now()) => {
  * A time ahead, for a due date or the next check: ISO 8601, or `30m`, `2h`, `3d` from now. `none`
  * is not a time; a caller that clears a date checks for it first.
  */
-export const aheadOf = (reference, flag, now = Date.now()) => {
+export const aheadOf = (reference, flag, now = Date.now(), at = {}) => {
     const wanted = reference.trim();
     const [, amount, unit] = AGO.exec(wanted) ?? [];
-    const time = amount && unit ? now + Number(amount) * (AGO_MS[unit] ?? 0) : DATE.test(wanted) ? Date.parse(wanted) : Number.NaN;
+    const time = amount && unit
+        ? now + Number(amount) * (AGO_MS[unit] ?? 0)
+        : DATE.test(wanted)
+            ? calendarMoment(wanted, flag, at)
+            : Number.NaN;
     if (Number.isNaN(time)) {
         throw new CliError("validation_error", `${flag} takes an ISO 8601 time or 30m, 2h, 3d from now — not "${wanted}"`);
     }

package/dist/services/project-gathering-request.d.ts

@@ -7,10 +7,7 @@ export interface ProjectGatheringRequest {
         aliases?: string[];
     };
     keywords?: string[];
-    people?: {
-        name: string;
-        reference?: string;
-    }[];
+    people?: ProjectPerson[];
     sources: ContextSource[];
     /** Chats the host confirmed as the project's; each is read whole, through the source of its own account. */
     linkedChats?: ProjectLinkedChat[];
@@ -30,6 +27,20 @@ export interface ProjectGatheringRequest {
     checkpoint?: string;
     signal?: AbortSignal;
 }
+/**
+ * `name` is searched as words; `senders` are the person's stored identities, and every message or mail one of them
+ * wrote in the window is read. A sender lane needs the person's `reference`.
+ */
+export interface ProjectPerson {
+    name?: string;
+    reference?: string;
+    senders?: ProjectSender[];
+}
+/** One stored identity by its provider and the provider's own id; an email identity's id is its address. */
+export interface ProjectSender {
+    provider: string;
+    id: string;
+}
 export interface ProjectLinkedChat {
     provider: string;
     account: string;
@@ -42,13 +53,15 @@ export interface ProjectGatheringBudgets {
     maxElapsedMs?: number;
     maxItems?: number;
 }
-export type ProjectLaneKind = "project" | "key" | "alias" | "keyword" | "person" | "linked-chat";
+export type ProjectLaneKind = "project" | "key" | "alias" | "keyword" | "person" | "sender" | "linked-chat";
 export interface ProjectLane {
     id: string;
     kinds: ProjectLaneKind[];
-    /** Null for a linked chat's lane, which reads every message of the chat. */
+    /** Null for a linked chat's or a sender's lane, which read every message of the chat or of the sender. */
     query: string | null;
     people: string[];
+    /** A sender lane only: the identities whose messages and mail it reads. */
+    senders?: ProjectSender[];
     /** A linked chat's lane only: the chat's reference. */
     chat?: string;
 }
@@ -96,10 +109,18 @@ export declare const projectGatheringRequest: (input: ProjectGatheringRequest, n
         aliases: string[];
     };
     keywords: string[];
-    people: {
+    people: ({
         name: string;
         reference: string | null;
-    }[];
+        senders?: undefined;
+    } | {
+        name: string | null;
+        reference: string | null;
+        senders: {
+            provider: string;
+            id: string;
+        }[];
+    })[];
     lanes: ProjectLane[];
     sources: ContextSource[];
     linkedChats: {
@@ -148,6 +169,7 @@ export declare const projectUnits: (plan: ProjectGatheringPlan, window: {
         before: number;
     };
     chat: string | undefined;
+    senders: string[] | undefined;
 }[];
 export declare const seenKey: (ref: string) => string;
 export declare const encodeCheckpoint: (checkpoint: ProjectGatheringCheckpoint) => string;

package/dist/services/project-gathering-request.js

@@ -6,7 +6,15 @@ import { formatReference } from "../domain/references.js";
 const DAY = 86400000;
 const MAX_TIME = 8_640_000_000_000_000;
 export const CONTEXT_CHUNK_DAYS = 90;
-const LIMITS = { lanes: 16, sources: 32, units: 512, lookbackDays: 730, people: 16, linkedChats: 16 };
+const LIMITS = {
+    lanes: 16,
+    sources: 32,
+    units: 512,
+    lookbackDays: 730,
+    people: 16,
+    linkedChats: 16,
+    senders: 16,
+};
 const BUDGETS = {
     maxReads: [48, 512],
     maxReadBytes: [2097152, 16777216],
@@ -77,11 +85,29 @@ export const projectGatheringRequest = (input, now) => {
     const people = list(input.people, "people", LIMITS.people).map((person, i) => {
         if (!person || typeof person !== "object")
             return fail(`people.${i} needs a name`, `people.${i}`);
-        known(person, ["name", "reference"], `people.${i}.`);
+        known(person, ["name", "reference", "senders"], `people.${i}.`);
         const p = person;
+        const reference = p.reference === undefined ? null : text(p.reference, `people.${i}.reference`, 1024);
+        if (p.senders === undefined)
+            return { name: laneQuery(p.name, `people.${i}.name`), reference };
+        const senders = list(p.senders, `people.${i}.senders`, LIMITS.senders).map((value, j) => {
+            const name = `people.${i}.senders.${j}`;
+            if (!value || typeof value !== "object")
+                return fail(`${name} needs provider and id`, name);
+            known(value, ["provider", "id"], `${name}.`);
+            const given = value;
+            return { provider: text(given.provider, `${name}.provider`, 128), id: text(given.id, `${name}.id`, 1024) };
+        });
+        if (!senders.length)
+            fail(`people.${i}.senders needs at least one identity`, `people.${i}.senders`);
+        if (new Set(senders.map((one) => JSON.stringify([one.provider, one.id]))).size !== senders.length)
+            fail(`people.${i}.senders lists one identity twice`, `people.${i}.senders`);
+        if (reference === null)
+            fail(`people.${i} needs a reference to read by sender`, `people.${i}.reference`);
         return {
-            name: laneQuery(p.name, `people.${i}.name`),
-            reference: p.reference === undefined ? null : text(p.reference, `people.${i}.reference`, 1024),
+            name: p.name === undefined ? null : laneQuery(p.name, `people.${i}.name`),
+            reference,
+            senders,
         };
     });
     if (input.scope !== "explicit" && input.scope !== "all-connected")
@@ -139,7 +165,17 @@ export const projectGatheringRequest = (input, now) => {
     for (const k of keywords)
         lane("keyword", k);
     for (const p of people)
-        lane("person", p.name, p.reference ?? p.name);
+        if (p.name !== null)
+            lane("person", p.name, p.reference ?? p.name);
+    for (const p of people)
+        if (p.senders && p.reference !== null)
+            lanes.push({
+                id: `l${lanes.length + 1}`,
+                kinds: ["sender"],
+                query: null,
+                people: [p.reference],
+                senders: p.senders,
+            });
     if (lanes.length > LIMITS.lanes)
         fail(`at most ${LIMITS.lanes} distinct search lanes`, "keywords");
     for (const linked of linkedChats) {
@@ -248,16 +284,33 @@ export const projectUnits = (plan, window) => {
         sourceIndex,
         chunk,
         chat: undefined,
+        senders: undefined,
     }))));
-    // Appended after every literal unit: a checkpoint from a run without links keeps its unit order, and in each
+    // Only the sources of a sender's own provider: an identity of one messenger never wrote in another.
+    const bySender = chunks.flatMap((chunk) => plan.lanes.flatMap((lane) => plan.sources.flatMap((source, sourceIndex) => {
+        if (!lane.senders || (source.kind !== "message" && source.kind !== "mail"))
+            return [];
+        const ids = lane.senders.filter((one) => one.provider === source.provider).map((one) => one.id);
+        return ids.length ? [{ lane, source, sourceIndex, chunk, chat: undefined, senders: ids }] : [];
+    })));
+    // Appended after every literal and sender unit: a checkpoint from a run without links keeps its unit order, and in each
     // round a literal lane labels a shared hit before the linked chat does.
     const linked = chunks.flatMap((chunk) => plan.linkedChats.flatMap(({ lane, source, chat }) => {
         const found = plan.lanes.find((l) => l.id === lane);
         return found && source !== null
-            ? [{ lane: found, source: plan.sources[source], sourceIndex: source, chunk, chat }]
+            ? [
+                {
+                    lane: found,
+                    source: plan.sources[source],
+                    sourceIndex: source,
+                    chunk,
+                    chat,
+                    senders: undefined,
+                },
+            ]
             : [];
     }));
-    const units = [...literal, ...linked];
+    const units = [...literal, ...bySender, ...linked];
     if (units.length > LIMITS.units)
         fail(`${units.length} lane × source × 90-day reads exceed ${LIMITS.units}; narrow the lanes, sources or window`);
     return units;

package/dist/services/project-gathering.d.ts

@@ -39,8 +39,11 @@ export interface ProjectEvidenceItem extends Omit<ContextEvidenceItem, "text"> {
     /** A document hit with `around`: how many paragraphs after the one it centres on also name a lane word. */
     moreMatches?: number;
 }
-/** Strongest first: a hit that names the project, then one only from a linked chat, then one naming only a person. */
-export type ProjectEvidenceContext = "project" | "linked-chat" | "person-only";
+/**
+ * Strongest first: a hit that names the project, then one only from a linked chat, then one a person wrote, then one
+ * naming only a person.
+ */
+export type ProjectEvidenceContext = "project" | "linked-chat" | "sender" | "person-only";
 export type ProjectGatheringStop = "reads" | "read-bytes" | "elapsed" | "items" | null;
 export declare const gatherProjectEvidence: (ports: ProjectGatheringPorts, request: ProjectGatheringRequest) => Promise<{
     schemaVersion: 1;

package/dist/services/project-gathering.js

@@ -5,12 +5,14 @@ import { excerpt } from "./excerpt.js";
 import { attachNeighbours, documentMatches, } from "./project-gathering-around.js";
 import { decodeCheckpoint, encodeCheckpoint, projectGatheringRequest, projectUnits, seenKey, } from "./project-gathering-request.js";
 const terminal = new Set(["done", "unavailable", "failed"]);
-const CONTEXTS = ["person-only", "linked-chat", "project"];
+const CONTEXTS = ["person-only", "sender", "linked-chat", "project"];
 const contextOf = (lane) => lane.kinds.includes("linked-chat")
     ? "linked-chat"
-    : lane.kinds.every((k) => k === "person")
-        ? "person-only"
-        : "project";
+    : lane.kinds.includes("sender")
+        ? "sender"
+        : lane.kinds.every((k) => k === "person")
+            ? "person-only"
+            : "project";
 export const gatherProjectEvidence = async (ports, request) => {
     if (!ports?.evidence || typeof ports.evidence.read !== "function")
         throw new CliError("configuration_error", "stored context reads are unavailable in this store");
@@ -164,7 +166,11 @@ export const gatherProjectEvidence = async (ports, request) => {
                 try {
                     const page = await reader.read({
                         source: unit.source,
-                        ...(unit.chat === undefined ? { query: unit.lane.query ?? undefined } : { chat: unit.chat }),
+                        ...(unit.chat !== undefined
+                            ? { chat: unit.chat }
+                            : unit.senders !== undefined
+                                ? { senders: unit.senders }
+                                : { query: unit.lane.query ?? undefined }),
                         after: unit.chunk.after,
                         before: unit.chunk.before,
                         limit,