@wirecat/cli-core 0.586.0 → 0.587.0

package/CHANGELOG.md

@@ -5,7 +5,23 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.587.0 — 06.11.2026
+
+### Added
+
+- **`answerLocally` and `wallClock` in `@wirecat/cli-core/cli`.** `answerLocally` answers as `renderAnswer` does, and a
+  person reads each UTC time as `YYYY-MM-DD HH:MM` in the zone in use, with one `times in <zone>` line on stderr; a
+  `view` gets the formatter to build its text with. JSON, JSONL, `--compact` and agents keep UTC. `hitText` takes the
+  formatter as an optional third argument. mail can drop its own copy (`src/commands/times.ts`).
+- **cli-core accepts `@wirecat/cli-base` 0.80 (peer range `>=0.76.0 <0.81.0`) and builds with 0.80.0**, which
+  adds the `--write <id>` flag mail's `messages restore` takes. The range was `<0.80.0`.
+
+### Fixed
+
+- **`search messages`, `messages show`, `conversations list|show`, mail `review`, `runs list` and `runs show` show a
+  person times in the local zone** (WC-TIME-4), with a last line `times in <zone>`. They printed UTC ISO strings
+  such as `2026-10-03T09:00:00.000Z`. `search messages --timezone` decides the zone shown. JSON and storage keep UTC.
+  `runs list|show` is shared by every tool on cli-core; the mail screens reach mail and memo at their next bump.
 
 ## 0.586.0 — 06.11.2026
 

package/dist/calendar/cli/local-times.js

@@ -1,26 +1,16 @@
 import { renderPretty } from "@wirecat/cli-base";
-const UTC_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/u;
+import { UTC_TIME, wallClock } from "../../cli/local-times.js";
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
  * A calendar answer as a person reads it at a terminal (WC-TIME-4): each UTC time on the wall clock of `zone`, an
  * all-day event's times as its local dates, and a last line naming the zone. JSON keeps the UTC times.
  */
 export const localTimesView = (value, zone, color) => {
-    const clock = new Intl.DateTimeFormat("en-CA", {
-        timeZone: zone,
-        year: "numeric",
-        month: "2-digit",
-        day: "2-digit",
-        hour: "2-digit",
-        minute: "2-digit",
-        hourCycle: "h23",
-    });
+    const clock = wallClock(zone);
     let shown = false;
     const local = (text, dateOnly) => {
-        const part = Object.fromEntries(clock.formatToParts(Date.parse(text)).map(({ type, value }) => [type, value]));
         shown = true;
-        const date = `${part.year}-${part.month}-${part.day}`;
-        return dateOnly ? date : `${date} ${part.hour}:${part.minute}`;
+        return dateOnly ? clock.date(text) : clock.time(text);
     };
     const walk = (one, allDay = false) => {
         if (typeof one === "string")

package/dist/cli/index.d.ts

@@ -86,6 +86,7 @@ export { type HelpSection, inSection, SECTIONS } from "./help/sections.js";
 export { bufferedInput, type InputPolicy, inputPolicy, MAX_BUFFERED_INPUT, MAX_SECRET_INPUT, provideInputPolicy, } from "./input-policy.js";
 export { answerFields, checkJson, type EntityFields, entityFields, type JsonFieldsResolver, type JsonRequest, liftJson, } from "./json-fields.js";
 export { commandPath, LIST_QUERY_GUIDE, listQuery, nativeField, nativeTermLists, nativeTerms, negatableOf, pagedList, pageOf, type QueryWords, queryArgument, queryHelp, queryTerms, searchText, termField, timeBounds, typedQuery, unfilteredQuery, withQuery, } from "./list-query.js";
+export { answerLocally, type ShownTime, wallClock } from "./local-times.js";
 export { MCP_HTTP_DEFAULT_PORT, type McpServerOptions, type McpServerTarget, mcpServerCommand, } from "./mcp-server-command.js";
 export { formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
 export { meetingEvidenceItem, meetingPersonContextItem } from "./meeting-evidence-answer.js";

package/dist/cli/index.js

@@ -77,6 +77,7 @@ export { inSection, SECTIONS } from "./help/sections.js";
 export { bufferedInput, inputPolicy, MAX_BUFFERED_INPUT, MAX_SECRET_INPUT, provideInputPolicy, } from "./input-policy.js";
 export { answerFields, checkJson, entityFields, liftJson, } from "./json-fields.js";
 export { commandPath, LIST_QUERY_GUIDE, listQuery, nativeField, nativeTermLists, nativeTerms, negatableOf, pagedList, pageOf, queryArgument, queryHelp, queryTerms, searchText, termField, timeBounds, typedQuery, unfilteredQuery, withQuery, } from "./list-query.js";
+export { answerLocally, wallClock } from "./local-times.js";
 export { MCP_HTTP_DEFAULT_PORT, mcpServerCommand, } from "./mcp-server-command.js";
 export { formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
 export { meetingEvidenceItem, meetingPersonContextItem } from "./meeting-evidence-answer.js";

package/dist/cli/local-times.d.ts

@@ -0,0 +1,16 @@
+import type { Command } from "commander";
+import { type AnswerOutput, type Body } from "./envelope.js";
+export declare const UTC_TIME: RegExp;
+/** `YYYY-MM-DD HH:MM` on the wall clock of `zone`, with no offset: the answer names the zone once. */
+export declare const wallClock: (zone: string) => {
+    date: (iso: string) => string;
+    time: (iso: string) => string;
+};
+/** Turns a UTC time into the shown one; any other text comes back as it was. */
+export type ShownTime = (value: string) => string;
+/**
+ * Answers as `renderAnswer` does, and a person reads every UTC time in the zone in use (`zone`, else the computer's),
+ * with one line naming it (WC-TIME-4). A `view` builds its text with the `shown` it is given. JSON, JSONL, compact
+ * rows and agents keep UTC (WC-TIME-2), and `next` is left alone: its args run.
+ */
+export declare const answerLocally: <T>(command: Command, output: AnswerOutput, body: Body<T>, view?: (shown: ShownTime) => string, zone?: string) => void;

package/dist/cli/local-times.js

@@ -0,0 +1,65 @@
+import { timezoneOf } from "@wirecat/cli-base/query";
+import { environmentOf } from "./context.js";
+import { renderAnswer } from "./envelope.js";
+export const UTC_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/u;
+/** `YYYY-MM-DD HH:MM` on the wall clock of `zone`, with no offset: the answer names the zone once. */
+export const wallClock = (zone) => {
+    const format = new Intl.DateTimeFormat("en-CA", {
+        timeZone: zone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    });
+    const parts = (iso) => Object.fromEntries(format.formatToParts(Date.parse(iso)).map(({ type, value }) => [type, value]));
+    const date = (iso) => {
+        const part = parts(iso);
+        return `${part.year}-${part.month}-${part.day}`;
+    };
+    return {
+        date,
+        time: (iso) => {
+            const part = parts(iso);
+            return `${part.year}-${part.month}-${part.day} ${part.hour}:${part.minute}`;
+        },
+    };
+};
+const localised = (value, shown) => {
+    if (typeof value === "string")
+        return shown(value);
+    if (Array.isArray(value))
+        return value.map((one) => localised(one, shown));
+    if (value !== null && typeof value === "object")
+        return Object.fromEntries(Object.entries(value).map(([key, one]) => [key, localised(one, shown)]));
+    return value;
+};
+/**
+ * Answers as `renderAnswer` does, and a person reads every UTC time in the zone in use (`zone`, else the computer's),
+ * with one line naming it (WC-TIME-4). A `view` builds its text with the `shown` it is given. JSON, JSONL, compact
+ * rows and agents keep UTC (WC-TIME-2), and `next` is left alone: its args run.
+ */
+export const answerLocally = (command, output, body, view, zone) => {
+    if (output.format !== "pretty" || output.compact || environmentOf(command).agent) {
+        renderAnswer(command, output, body, view && (() => view((value) => value)));
+        return;
+    }
+    const inUse = timezoneOf(zone);
+    const clock = wallClock(inUse);
+    let seen = false;
+    const shown = (value) => {
+        if (!UTC_TIME.test(value))
+            return value;
+        seen = true;
+        return clock.time(value);
+    };
+    if (view)
+        renderAnswer(command, output, body, () => view(shown));
+    else
+        renderAnswer(command, output, ("items" in body
+            ? { ...body, items: body.items.map((one) => localised(one, shown)) }
+            : { ...body, item: localised(body.item, shown) }));
+    if (seen)
+        output.renderer.note(`times in ${inUse}`);
+};

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
-    error?: undefined;
     path: string;
     exists: boolean;
+    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/runs/command.js

@@ -6,6 +6,7 @@ import { environmentOf, outputFor } from "../context.js";
 import { LOCAL_READ, NO_EFFECTS } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { typedQuery, withQuery } from "../list-query.js";
+import { answerLocally } from "../local-times.js";
 import { positiveCount } from "../paging.js";
 import { lineOf } from "../steps.js";
 import { RUNS_QUERY, runListFilter } from "./query.js";
@@ -33,7 +34,7 @@ export const runsCommand = (app) => {
         const { renderer } = output;
         const runs = listRuns(dir(this), { atLeast: page * limit + 1, filter });
         const shown = runs.slice((page - 1) * limit, page * limit);
-        renderAnswer(this, output, listOf("runs list", {
+        answerLocally(this, output, listOf("runs list", {
             items: shown.map(snakeKeys),
             limit,
             page,
@@ -60,7 +61,7 @@ export const runsCommand = (app) => {
         const { problems } = this.opts();
         const shown = problems ? events.filter(notable) : events;
         // Events are log records as written; only the run's own fields are renamed here.
-        renderAnswer(this, output, itemOf({
+        answerLocally(this, output, itemOf({
             ...snakeKeys(found.metadata),
             directory: found.dir,
             event_count: events.length,

package/dist/mail/cli/index.js

@@ -6,8 +6,9 @@ import * as v from "valibot";
 import { answerEntity } from "../../cli/answer-entity.js";
 import { environmentOf, outputFor } from "../../cli/context.js";
 import { FETCH, LOCAL_READ, REMOTE_READ } from "../../cli/effects.js";
-import { itemOf, listOf, renderAnswer, snakeKeys } from "../../cli/envelope.js";
+import { itemOf, listOf, snakeKeys } from "../../cli/envelope.js";
 import { listQuery, typedQuery, withQuery } from "../../cli/list-query.js";
+import { answerLocally } from "../../cli/local-times.js";
 import { messagesAnswer, offsetOf, shownOf } from "../../cli/messenger/search-answers.js";
 import { backendRequest, noteServer, serverSearchOptions } from "../../cli/messenger/search-backend-options.js";
 import { positiveCount } from "../../cli/paging.js";
@@ -193,7 +194,7 @@ Search guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/quer
         const issues = serverIssues(found.server);
         if (issues.length)
             answer.meta = { ...answer.meta, complete: false, issues: [...(answer.meta?.issues ?? []), ...issues] };
-        renderAnswer(this, output, answer, () => {
+        answerLocally(this, output, answer, (local) => {
             if (!found.wordsReady)
                 output.renderer.note(`the word index is still being built — \`${mail.app.command} store migrate\` finishes it`);
             noteServer(output, found.server);
@@ -204,12 +205,12 @@ Search guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/quer
             const shown = shownOf(found.items.length, (page - 1) * limit, found.total);
             if (shown)
                 output.renderer.note(shown);
-            return found.items.map((item) => `${hitText(item, level)}\n`).join("");
-        });
+            return found.items.map((item) => `${hitText(item, level, local)}\n`).join("");
+        }, options.timezone);
     });
     return new Command("search").summary("search the stored mail").description("find stored emails").addCommand(leaf);
 };
-const shownText = (emails) => `${emails.map((email) => [hitText(email, "full"), attachmentsText(email)].filter(Boolean).join("\n")).join("\n\n")}\n`;
+const shownText = (emails, local) => `${emails.map((email) => [hitText(email, "full", local), attachmentsText(email)].filter(Boolean).join("\n")).join("\n\n")}\n`;
 const messagesCommand = (mail) => {
     const messages = new Command("messages").summary("read stored emails").description("read the emails sync stored");
     annotate(messages.command("show"), {
@@ -249,9 +250,9 @@ const messagesCommand = (mail) => {
         });
         const output = outputFor(this);
         const shown = emails.map((email) => snakeKeys(atDetail(email)));
-        renderAnswer(this, output, beforeN || afterN
+        answerLocally(this, output, beforeN || afterN
             ? listOf("messages show", { items: shown, limit: Math.max(1, shown.length), has_more: false })
-            : itemOf(shown.find((_, at) => emails[at]?.anchor) ?? shown[0], unread ? { meta: { complete: false, issues: [unread] } } : undefined), () => shownText(emails));
+            : itemOf(shown.find((_, at) => emails[at]?.anchor) ?? shown[0], unread ? { meta: { complete: false, issues: [unread] } } : undefined), (local) => shownText(emails, local));
     });
     messages.addCommand(acknowledgeCommand(mail));
     messages.addCommand(resetMarkCommand(mail));
@@ -315,14 +316,14 @@ const conversationsCommand = (mail) => {
             last_email_at: thread.lastEmailAt === null ? null : new Date(thread.lastEmailAt).toISOString(),
             untrusted: ["subject"],
         }));
-        renderAnswer(this, outputFor(this), listOf("conversations list", {
+        answerLocally(this, outputFor(this), listOf("conversations list", {
             items,
             limit,
             has_more: threads.length > limit,
             page,
             ...(typed.trim() ? { args: { query: typed } } : {}),
-        }), () => items
-            .map((one) => `${one.ref}\n  ${one.last_email_at ?? "time unknown"}  ${one.emails_count}  ${one.subject ?? ""}\n`)
+        }), (local) => items
+            .map((one) => `${one.ref}\n  ${one.last_email_at === null ? "time unknown" : local(one.last_email_at)}  ${one.emails_count}  ${one.subject ?? ""}\n`)
             .join(""));
     });
     answerEntity(list, "mail_thread", mailThread);
@@ -349,7 +350,7 @@ const conversationsCommand = (mail) => {
                 : hit));
         });
         const items = emails.map((email) => snakeKeys(atDetail(email)));
-        renderAnswer(this, outputFor(this), listOf("conversations show", { items, limit: Math.max(1, items.length), has_more: false }), () => shownText(emails));
+        answerLocally(this, outputFor(this), listOf("conversations show", { items, limit: Math.max(1, items.length), has_more: false }), (local) => shownText(emails, local));
     });
     return conversations;
 };

package/dist/mail/cli/review.js

@@ -5,8 +5,9 @@ import { defineSteps, MAX_NEXT_STEPS, stepOf, } from "@wirecat/cli-base/standard
 import { Command } from "commander";
 import { environmentOf, outputFor } from "../../cli/context.js";
 import { LOCAL_READ } from "../../cli/effects.js";
-import { listOf, renderAnswer } from "../../cli/envelope.js";
+import { listOf } from "../../cli/envelope.js";
 import { listQuery, nativeField, nativeTerms, queryHelp, typedQuery } from "../../cli/list-query.js";
+import { answerLocally } from "../../cli/local-times.js";
 import { pointsOf } from "../../cli/messenger/catch-up.js";
 import { catchUpQuery, SUMMARY_UNTRUSTED, summaryOf } from "../../cli/messenger/catch-up-answers.js";
 import { messageItem } from "../../cli/messenger/message-items.js";
@@ -231,11 +232,13 @@ const holderReview = async (command, mail, holder, query) => {
             : []),
     ];
     const output = outputFor(command);
-    renderAnswer(command, output, answer, () => {
+    answerLocally(command, output, answer, (local) => {
         output.renderer.note(read.mark
             ? `${holder}: past ${read.mark.throughId}${emails.length ? `; findings key ${read.findingsKey}` : ""}; acknowledge with --cursor ${read.cursor}${read.more ? "; more after these" : ""}`
             : `${holder} has no mark yet: it starts from now — acknowledge with --cursor ${read.cursor}`);
-        return emails.map((hit) => `${hitText(hit)}${markText(marks.get(hit.id), hit.excerptOnly)}\n`).join("");
+        return emails
+            .map((hit) => `${hitText(hit, undefined, local)}${markText(marks.get(hit.id), hit.excerptOnly)}\n`)
+            .join("");
     });
 };
 /**
@@ -311,7 +314,7 @@ an agent over MCP, and each scheduled run.`)
     const answer = reviewAnswer(found, mailbox, saved !== undefined, stepsFor(mail.mount, mailbox));
     if (meta)
         answer.meta = { ...meta, ...answer.meta };
-    renderAnswer(this, output, answer, () => {
+    answerLocally(this, output, answer, (local) => {
         const read = found.chats.flatMap((chat) => chat.messages);
         if (found.unanswered || found.waiting)
             output.renderer.note(`${[
@@ -319,16 +322,16 @@ an agent over MCP, and each scheduled run.`)
                 found.waiting ? `waiting ${found.waiting.olderThanHours}h or more` : "",
             ]
                 .filter(Boolean)
-                .join(", ")}, threads active from ${found.since}`);
+                .join(", ")}, threads active from ${local(found.since)}`);
         else
-            output.renderer.note(`from ${found.since} to ${found.until}${found.complete ? "" : ", incomplete"}`);
+            output.renderer.note(`from ${local(found.since)} to ${local(found.until)}${found.complete ? "" : ", incomplete"}`);
         if (found.quiet > 0)
             output.renderer.note(`bulk:false left out ${found.quiet} threads`);
         if (read.length === 0)
             output.renderer.note("nothing new in the stored mail");
         return read
             .sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp))
-            .map((hit) => `${hitText(hit)}${markText(hit.marks)}\n`)
+            .map((hit) => `${hitText(hit, undefined, local)}${markText(hit.marks)}\n`)
             .join("");
     });
     saved?.save(found.checked ?? {}, found.complete ? { through: found.until } : {});

package/dist/mail/read.d.ts

@@ -54,7 +54,7 @@ export declare const showMail: (store: MessageStore, locator: string, { before,
  */
 export declare const hitText: (item: StoredHit & {
     excerpt?: string;
-}, level?: "brief" | "full") => string;
+}, level?: "brief" | "full", shown?: (time: string) => string) => string;
 /** Each attachment of a shown email with its text indented under it, or why it has none. */
 export declare const attachmentsText: (hit: ShownMail) => string;
 export {};

package/dist/mail/read.js

@@ -82,7 +82,7 @@ const line = (text) => text.replace(/\s+/g, " ").trim();
  * A found message or email for a reader: its reference first, then when and from whom, who else it went to and
  * where it is filed, its subject or chat, and an excerpt — the whole text only at `full`.
  */
-export const hitText = (item, level) => {
+export const hitText = (item, level, shown = (time) => time) => {
     const mail = item.email;
     const names = (people) => people.map(({ name, address }) => line(name ?? address)).join(", ");
     const between = mail
@@ -97,7 +97,7 @@ export const hitText = (item, level) => {
     const who = line(item.senderName ?? item.senderId ?? "unknown");
     return [
         item.locator,
-        `  ${item.timestamp}  ${who}${level === "brief" || !between ? "" : `  ${between}`}`,
+        `  ${shown(item.timestamp)}  ${who}${level === "brief" || !between ? "" : `  ${between}`}`,
         ...(level === "brief" || !item.chatTitle ? [] : [`  ${line(item.chatTitle)}`]),
         `  ${level === "full" ? item.text.replace(/\n/g, "\n  ") : line(item.excerpt ?? item.text)}`,
     ].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.586.0",
+  "version": "0.587.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",
@@ -258,7 +258,7 @@
     "@types/node": "^22.20.5",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.5",
-    "@wirecat/cli-base": "0.79.0",
+    "@wirecat/cli-base": "0.80.0",
     "@wirecat/cli-core-legacy-tags": "npm:@wirecat/cli-core@0.414.0",
     "commander": "15.0.0",
     "cspell": "10.4.0",
@@ -278,7 +278,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.76.0 <0.80.0",
+    "@wirecat/cli-base": ">=0.76.0 <0.81.0",
     "commander": ">=15"
   },
   "bin": {