@wirecat/cli-core 0.378.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/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/store/sqlite/facts.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { FACT_TYPES, MEMORY_SCOPES } from "../../domain/knowledge.js";
+import { calendarMoment } from "../../domain/moment.js";
 import { linkKind } from "./link-kinds.js";
 import { authorActor, authorOf, evidenceOf, linkEvidence } from "./memories.js";
 import { requiredThing } from "./notes.js";
@@ -64,7 +65,7 @@ export const factOperationsOver = (context) => {
             if (!statement || statement.length > 2000)
                 throw new CliError("validation_error", "a fact's statement takes 1–2000 characters");
             const scope = input.scope === undefined ? null : oneOf(input.scope, MEMORY_SCOPES, "a fact's scope");
-            const occurredAt = input.occurredAt === undefined ? null : Date.parse(input.occurredAt);
+            const occurredAt = input.occurredAt === undefined ? null : calendarMoment(input.occurredAt, "occurredAt");
             if (occurredAt !== null && !Number.isFinite(occurredAt))
                 throw new CliError("validation_error", "occurredAt takes an ISO timestamp");
             if (input.supersedes !== undefined && type !== "decision")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.378.0",
+  "version": "0.379.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",
@@ -202,7 +202,7 @@
     "@types/node": "^22.20.4",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.2",
-    "@wirecat/cli-base": "0.47.3",
+    "@wirecat/cli-base": "0.48.0",
     "commander": "15.0.0",
     "cspell": "10.3.6",
     "drizzle-kit": "1.0.0-rc.4",
@@ -222,7 +222,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.47.3 <0.48.0",
+    "@wirecat/cli-base": ">=0.48.0 <0.49.0",
     "commander": ">=15"
   },
   "bin": {