@wirecat/cli-core 0.550.0 → 0.551.0

package/CHANGELOG.md

@@ -7,6 +7,182 @@ shape of this file.
 
 ## Unreleased
 
+## 0.551.0 — 02.11.2026
+
+### Added
+
+- **`messages sync` keeps to the history limits too**, for every messenger: it does not read a group above
+  `history_group_members_max` people and stops a chat at its window (`history_dialog_days`, `history_group_days`). The
+  answer says `limited` (`group_too_large`, `older_than_window`; `--all` counts both), the skip is recorded for
+  `store status` and the search answers' `missing.history_limits`, and `--full-history` reads past it. Live messages
+  are never dropped.
+- **`readClientFile` (from `@wirecat/cli-core/oauth`) reads a user's own Google Desktop OAuth client file** (the
+  `{ "installed": { client_id, client_secret } }` JSON from Google's console). It refuses a file other users can read
+  (`sign-in.client-file-open`) and a file of the wrong shape (`sign-in.client-file-invalid`), and never puts the file's
+  contents in an error. gcal, drive and mail each kept a copy of this reader.
+- **`openBrowser(url, browser?)` is exported from `@wirecat/cli-core/cli`**, so a CLI that does not start through
+  `startCli` opens the sign-in page the same way: `open`, `rundll32` or `xdg-open`, or the named browser.
+- **iCalendar feeds as read-only calendars.** With `deps.feeds` (`icsFeeds`), `calendars add <url> [--title]` follows a
+  public holiday calendar, a sports schedule or a published `.ics` address, and `calendars remove <calendar>` stops.
+  `sync` reads each feed after the provider (`syncWithFeeds`), so its events show in `events list`,
+  `search events`, `overlapping:` and `events remind`. Repeating events are expanded here (`expandSeries`: RRULE in
+  the event's own zone, RDATE, EXDATE and overrides). The address is a secret input, kept by the CLI and never
+  printed; a fetch follows redirects only to https and stops at 10 MB and 30 s. `readIcs` takes
+  `{ overrides: true }` and returns the calendar's `name`. See `docs/dev/CALENDARS.md`, "Feeds".
+- **History limits for pushed history, per profile.** A messenger whose history is pushed (`history: "store"`,
+  WhatsApp) saves one-to-one chats back `history_dialog_days` (1095 by default), groups of more than two people back
+  `history_group_days` (365) and nothing of a group above `history_group_members_max` people (50); at most 1095 days.
+  The chat row stays, so the chat is still listed. Live messages, `messages sync` and what the store already holds are
+  never dropped. `messages sync <chat> --full-history` fetches a chat and keeps its pushed history in full from then on
+  (`history_included` in the answer). `ChatsStore` gains `historySkips`, `historyShapes`, `recordHistorySkips` and
+  `setHistoryIncluded`; `Saving` takes `historyLimits`.
+- **Helpers for reading money and questions in a chat, for the project status work.** `amountsOf(text)` returns
+  every amount in a text, in order (`amountOf` is its first). `MONEY_REQUEST`, `MONEY_DONE` and `PROMISE` word lists
+  (ru, en, es) with `moneyClassesOf(text)` say which a text uses. `questions(messages, { asker: "owner" })` lists the
+  owner's own questions and whether anyone but the owner answered them, by a reply or by speaking next; the default,
+  `"others"`, is what it did before. `linkedChatsOf` is exported, now with each link's `role`, and so is
+  `AGENDA_DEFAULTS`, the silence `tasks agenda` waits before it lists a chat.
+- **A command's own history handler learns whether each batch reached the store**: `HistoryBatchHandler` takes
+  `saved`, a promise of the same `true` or `false` the messenger gets, so a link can count only what was kept.
+- **Every messenger command that takes a chat or a message also takes the reference other WireCat CLIs print**:
+  `chat:<provider>/<account>/<chat>` wherever a chat is named (`messages list chat:max/34871122/63488582`, bot
+  commands too), and `msg:<provider>/<account>/<chat>/<message>` wherever a chat or a message is, online and offline. A person lookup takes `contact:<provider>/<id>`. A reference of another
+  account is refused, naming the account it belongs to and the profiles of this CLI the store saw on it; it never
+  switches account. One of another messenger is refused with the command that opens it (`open it with tg <profile>
+  messages list chat:telegram/…`), and another kind (`document:413` given as a chat) with what the argument takes.
+- **`event:<id>` and `meeting:<account>/<meeting>[/<transcript>[/<cue>]]` parse with `parseReference`** and
+  `canonicalReference`, as every other kind: `event:N` was printed by the calendar and person answers and could not be
+  read back. The kinds are one table, `REF_KINDS`; `looksLikeReference(text)` tells a reference from a title such as
+  `Note: plan`. Reference errors carry a reason: `ref.malformed`, `ref.unknown-kind` (with the kind meant:
+  `"doc:413" … did you mean document:413?`), `ref.wrong-kind`, `ref.wrong-provider`, `ref.wrong-account`.
+- **`messages list` reads a window bounded on both sides, offline too.** The query takes a start and an end,
+  `'date>=2026-10-01 date<2026-10-20'` or `'date:[2026-10-01 TO 2026-10-19]'`, and `id>` with `date<`. A start reads
+  forward, oldest first, and stops at the end; an end alone reads back from it, newest page first, as before.
+  `--offline` and a messenger whose history is read from the store (WhatsApp) now answer both ways from the store
+  instead of refusing. A forward cursor carries the end, `after:<id>~<epoch ms>`, so the next page stops at the same
+  place. `--since`, `--since-time`, `--until`, `--until-time`, `--after-time` and `--before-time` on `messages list`
+  fail with the query form to type instead. The store's `messages()` window takes `after` (a message or a moment)
+  and `until`.
+- **`projects status <project>`: where a project stands, from the store alone, with no model call.** For each chat
+  confirmed as the project's or a child project's, in this profile's account: the last message, who replies next
+  (you, them, a member a message names, or nobody), open questions both ways, promises (stored tasks, promise facts,
+  and first person future words such as "пришлю" or "I'll send"), amounts with their direction and whether a later
+  message says paid, payment facts, how long each `--context-query` (words that all appear in one text) has been
+  quiet on their side, and how much of the chat the store holds. Open amounts are summed per direction and currency. Word matches are marked `basis: pattern`;
+  a message saying "paid" is `paid-mentioned`, never paid. At most two steps: sync the chat held in part, then read
+  the chat that needs you most. The other accounts' linked chats are named in `out_of_scope`. tg and max get it with
+  the `projects` group; `--compact` draws each signal with its own row.
+  - **For an app: `projectStatus(store, input)`, a list of signals in `STATUS_SIGNALS`.** A signal is one file with an
+    id, a version and `read`; one that throws is named in `failed` and the others still answer. Each built in signal
+    has its compact row in `STATUS_SIGNAL_ROWS`, also in `SHARED_ROWS`. `projectStatusAnswer` and `projectStatusText`
+    build the answer and the human form. `input.purposes` picks which chat purposes are read (`["work"]` until links
+    carry one). The `messages.list` step takes a `query`.
+- **`--compact`: one line per item for an agent, from the same answer `--json` prints.** `messages list <chat>
+  --compact` prints `#<id> · 10-01 09:12 · Анна · <text>` under one header line that names the shared ref prefix
+  (`ref: msg:max/500/-1001/<id>`), what every row has in common (the chat's title), the date span and the zone. Rows
+  from several chats keep their whole refs. Text stays on one line with control and direction characters made
+  visible, and is cut at 400 characters with `…(+N)`; `--full` keeps it whole. The paging, `missing`, the next steps
+  and an incomplete answer follow as `# more:`, `# missing:`, `# next:` and `# complete: false` lines on stdout, and
+  each command line in them carries `--compact` again. On 1 000 messages of one chat it is about 48 % of the JSON
+  bytes; the texts alone are 40 %. `--compact` with `--json`, `--json=…`, `--jsonl` or `--brief` fails with
+  `validation_error` (`output.conflict`); it never prompts, and exits with the code JSON would. MCP keeps JSON.
+  - **Every command that answers through `renderAnswer` gets it.** A command draws with its own row
+    (`answerEntity(cmd, name, schema, { row })`), its app's (`rows: { name: shape }` in the program definition,
+    which also draws an app entity listed inside one thing), the shared one in `SHARED_ROWS` (`message`,
+    `message.summary`, `message.hit`, `chat`), or the generic row: key, ref or id · title, name or path · state,
+    status or due date · text. A record or a list is never printed as a column's value. `RowShape` is data, and `compactText(body, shape,
+    options)` is pure, for an app that prints its own answers.
+  - What a command prints without `renderAnswer` stays JSON under `--compact`.
+- **`scanProjectLinks(store, { project, sources, since, write, scorers?, threshold?, limit?, purposes? })` and
+  `LinkScorer` (`@wirecat/cli-core/services`): memo proposes a project's chats, mail threads and people itself.**
+  Six scorers in `SCORERS` (`chat-title`, `alias-hits`, `member-chats`, `member-dialog`, `chat-senders`,
+  `mail-thread`) and the shared mail domain rule as `email-domain` in `PERSON_SCORERS`. Signals combine as
+  1 − Π(1 − w); at most 20 new proposals a run by the rule bot `memo-scan`, never confirmed by themselves. Each
+  carries `score` and `signals` (scorer, weight, why: ids and counts only). Linked and rejected pairs are skipped,
+  a pending one is updated in place; people are matched by identity only, never by name. `write: false` writes nothing.
+- **`knowledge.relationState(scope, { from, to, kind })`** says whether a link joins a pair, whether a proposal for it
+  was rejected, and which one is pending; `proposeRelation` takes `score` and `signals`.
+- **Payments are facts of type `payment`.** The amount (text, two decimals), ISO 4217 currency, direction (`to_us` or
+  `from_us`), counterparty ref or name, due date, state (`expected`, `paid`, `cancelled`) and item ride in
+  `metadata.payment`, read back as `Fact.payment`; no migration. A payment fact cites 1 to 8 references. Paid is a new
+  fact that supersedes the expected one, so the history stays. Only the owner accepts or rejects a payment:
+  `mayDecide` takes `ownerOnly`. `facts.list({ payment: { open, direction, state } })` filters them; `open` is
+  expected and still holding. `paymentTitle(fact)` reads "1 200 EUR to us from Ana, due 31.10 (expected)".
+  - **Agents stage payments as findings of kind `payment`** in `projects actions add`; confirming one writes and
+    accepts the fact, and a batch holding one is the owner's to decide. The inbox summarises each finding through
+    `FACT_SUMMARIES`, one row per kind. `projects status` lists payment facts with their title and adds the expected
+    ones to `money.open`, counting an ask the fact cites once.
+  - **For an app's `facts list`: `PAYMENT_QUERY_FIELDS` (`open:true`, `direction:to_us`, `state:paid`) and
+    `paymentFilterOf(terms)`.**
+
+### Changed — may break callers
+
+- **An option after `--` is read as the option.** `messages sync -- -100 --json` now syncs `-100` and answers in JSON;
+  it failed with "too many arguments". After `--`, a word that is exactly one of the command's options, its own or a
+  global one (`--json`, `--limit 5`, `--json=id`), moves in front of `--`; every other word stays a positional. A
+  negative id needs no `--` at all. Commands that take free text keep every word after `--` literal: `messages send` and
+  `edit` (also the bot's), `polls create`, `topics create`, `chats create`, `chats folders create`, `contacts rename`,
+  `contacts aliases set`, `messages press`, `bot commands set`, `schedule command`, `events remind`, `complete`, and the
+  notes templates. Mark such a command with `annotate(command, { literal_after_dashes: true })`; MCP calls are never
+  lifted. A script that passed the literal word `--json` as a positional of another command now gets the option instead.
+- **A write to a calendar the account may only read refuses before anything is asked or journaled**
+  (`calendar.read-only`): create, quick add, import, update, delete, respond and move, for a feed and for a provider's
+  `reader` or `free-busy` calendar alike. Before, only the target of a move was checked; the provider refused the rest.
+  `calendars busy` and `search --backend server` leave feed calendars out.
+- **A locator of another account or messenger is refused with a new text and a reason.** `messages show`, `context`,
+  `link` and `download` said "that locator belongs to another account; select its profile first" or "…belongs to
+  another messenger"; they now say `<ref> belongs to account <id>; profile <name> is account <id>` (`ref.wrong-account`)
+  or `<ref> is a <messenger> message; open it with …` (`ref.wrong-provider`). A script matching the old text matches
+  the reason instead.
+- **A text of the form `<kind>:<no spaces>` given as a chat is read as a reference**, so a chat titled `note:plan` is
+  no longer found by that title; give its id or a part of the title.
+- The provider seeds of `telegram`, `max` and `whatsapp` name their CLI (`command: tg`, `max`, `wa`), which a
+  provider clash message now shows (`telegram (messages, from tg)`).
+- **cli-core now needs `@wirecat/cli-base` 0.75.0**, which holds the `--full-history` switch's name and the help
+  without `OR` for a list its provider filters. A CLI that pins cli-base bumps it to 0.75.0 together with cli-core.
+- **`FACT_TYPES` gains `payment`, and a `Finding` may be a `PaymentFinding`.** A caller that lists facts with a fixed
+  type list, or reads `finding.title` on every finding that is not a fact, narrows by `kind` first. A memo older than
+  this release refuses a payment fact in `facts list`; ship memo's bump the same day. `MEETING_FACT_TYPES` is gone:
+  `FACT_TYPES` is the one list.
+
+### Fixed
+
+- **`messages delete` with no message id refuses with `validation_error`** before it connects. An empty id (`""`
+  or a lone comma) used to reach the messenger as a deletion of nothing and answer success.
+- **An MCP read or write whose answer named a step only the person can take (`user_action`) failed as a bug.** The
+  router dropped next steps this server does not offer by their command, and such a step has none. It is kept now;
+  a command step this server does not offer is still dropped.
+- **A sum written in groups of three read as the wrong amount: `50 000 ₽` was `0` and `4 300 ₽` was `300`**, because
+  only the last group was read. Groups after a space, a no-break or thin space, a dot or a comma (`50 000`,
+  `1.200 €`, `$1,200`) are one number now, a decimal part after them is kept (`5 000.50 ₽`), and amounts keep two
+  decimals instead of a whole number (`15.5 eur` was 16). This is the amount the duplicate check compares between
+  two tasks, so a reminder worded with a grouped sum is no longer compared on the wrong figure.
+- **`page.next` of `messages list` and `messages comments` runs as written.** It repeated the query's `id`/`date`
+  bound beside `--cursor`, which the command refuses as two starting points; it now keeps only `topic:` and
+  `starred:`.
+- **An inclusive start keeps a message sent exactly at it.** `messages list 'date>=2026-10-01'` skipped a message
+  sent at the first millisecond of the day, and `date<="…"` one sent at that moment.
+- **`--brief` now cuts a messenger search hit.** It only knew mail's camelCase hits, so `search messages --brief` in
+  tg, max and wa printed every field; it now keeps `ref`, `chat_title`, `timestamp`, `sender_name`, `excerpt` and
+  `score`. The default and `--full` answers are unchanged. Commands that print through `outputFor` now honour
+  `--brief` and `--full` too, and refuse them together as the others do.
+- **An Outlook or Exchange feed's events are read, no longer skipped.** Those feeds name time zones the Windows way,
+  `TZID:W. Europe Standard Time`, and the iCalendar reader took only IANA names (`Europe/Berlin`), so `calendars add`
+  and `sync` skipped every timed event of such a feed and counted it under `skipped`. A Windows name is now read as
+  the IANA zone Unicode CLDR gives it worldwide (territory `001`), in DTSTART, DTEND, RECURRENCE-ID, and in the TZID of
+  RDATE and EXDATE, which are stored with the IANA name. The 142 names are a table generated from CLDR release-49
+  (`scripts/windows-zones.ts` regenerates it); no new dependency. A TZID that is neither, such as Outlook's
+  `(UTC+01:00) Amsterdam, Berlin, Bern`, is still skipped.
+- **A list whose provider filters it no longer says in `--help` that its query takes `OR`.** With
+  `@wirecat/cli-base` 0.74.0 → 0.75.0, its `Syntax:` line names only what it takes: `field:value` terms joined by AND,
+  and the phrase, `word*` and range forms where a field takes them. Every CLI picks this up at its next cli-core bump.
+- **The browser login page of `mcp serve --http` names what the app asks to reach and the right command.** It always
+  said "reach your messages through `<app> mcp --http`"; a CLI that is not a messenger now says what it serves (gcal:
+  "your Google Calendar"), and every CLI names `<app> mcp serve --http`. `HttpOptions` takes `reaches` for the
+  wording; unset, the page says "your `<app>` data".
+- **`store jobs list` says in its help and its MCP description that its query takes `OR`.** The list reads every job
+  file and takes the whole query language, but its registry said the source filters it (`native`).
+
 ## 0.550.0 — 02.11.2026
 
 ### Changed — may break callers

package/THIRD_PARTY_NOTICES

@@ -758,3 +758,44 @@ Licensed under SIL Open Font License 1.1; see dist/charts/fonts/OFL.txt and SOUR
 
 PNG rasterization uses @resvg/resvg-js under MPL-2.0. Its original sources are
 available at https://github.com/thx/resvg-js/tree/v2.6.2.
+
+Windows time zone names mapped to IANA zones (dist/calendar/windows-zones.generated.js), generated from
+Unicode CLDR release-49, common/supplemental/windowsZones.xml (https://github.com/unicode-org/cldr).
+
+Copyright © 2001–2026 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+THIRD PARTY RIGHTS.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.
+
+SPDX-License-Identifier: Unicode-3.0

package/dist/calendar/ics.d.ts

@@ -2,7 +2,7 @@ import type { EntryStatus, EntryTransparency, ParticipantResponse } from "../mee
 /**
  * The part of iCalendar (RFC 5545, https://www.rfc-editor.org/rfc/rfc5545) the calendar commands read and write: one
  * VCALENDAR of VEVENTs, with no VTIMEZONE. Times are written in UTC; a time read with a TZID keeps that zone's name,
- * which the provider takes as it is.
+ * which the provider takes as it is. A Windows zone name, as Outlook and Exchange write it, is read as its IANA zone.
  */
 export interface IcsEvent {
     uid: string;

package/dist/calendar/ics.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { zonedMoment } from "@wirecat/cli-base/query";
+import { WINDOWS_ZONES } from "./windows-zones.generated.js";
 const CRLF = "\r\n";
 const LINE_OCTETS = 75;
 const escapeText = (text) => text
@@ -129,6 +130,8 @@ const contentLine = (line) => {
 const unescapeText = (text) => text.replace(/\\([\\;,nN])/gu, (_match, char) => (char === "n" || char === "N" ? "\n" : char));
 const DATE = /^(\d{4})(\d{2})(\d{2})$/u;
 const DATE_TIME = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})(Z?)$/u;
+/** `W. Europe Standard Time` → `Europe/Berlin`, CLDR's zone for the name worldwide; any other TZID as written. */
+const ianaZone = (tzid) => (Object.hasOwn(WINDOWS_ZONES, tzid) ? WINDOWS_ZONES[tzid] : tzid);
 /** A DATE or DATE-TIME: UTC with `Z`, in its TZID, or floating, read in `zone`. */
 const momentOf = (line, zone) => {
     const value = line.value.trim();
@@ -146,7 +149,7 @@ const momentOf = (line, zone) => {
     if (utc)
         return { at: Date.parse(`${local}Z`), zone: "UTC" };
     const named = line.params.TZID;
-    const where = named ?? zone;
+    const where = named === undefined ? zone : ianaZone(named);
     try {
         return { at: zonedMoment(local, where, { start: 0, end: local.length }), zone: where };
     }
@@ -231,7 +234,7 @@ const eventOf = (lines, zone, overrides = false) => {
     const recurrence = lines
         .filter(({ name }) => ["RRULE", "RDATE", "EXDATE"].includes(name))
         .map(({ name, params, value }) => {
-        const kept = Object.entries(params).map(([key, param]) => `;${key}=${paramValue(param)}`);
+        const kept = Object.entries(params).map(([key, param]) => `;${key}=${paramValue(key === "TZID" ? ianaZone(param) : param)}`);
         return `${name}${kept.join("")}:${value.trim()}`;
     });
     if (recurrence.length)

package/dist/calendar/windows-zones.generated.d.ts

@@ -0,0 +1 @@
+export declare const WINDOWS_ZONES: Readonly<Record<string, string>>;

package/dist/calendar/windows-zones.generated.js

@@ -0,0 +1,146 @@
+// Generated by scripts/windows-zones.ts from CLDR release-49 (Unicode License v3, THIRD_PARTY_NOTICES); do not edit by hand.
+// https://raw.githubusercontent.com/unicode-org/cldr/release-49/common/supplemental/windowsZones.xml
+export const WINDOWS_ZONES = {
+    "Afghanistan Standard Time": "Asia/Kabul",
+    "Alaskan Standard Time": "America/Anchorage",
+    "Alberta Standard Time": "America/Edmonton",
+    "Aleutian Standard Time": "America/Adak",
+    "Altai Standard Time": "Asia/Barnaul",
+    "Arab Standard Time": "Asia/Riyadh",
+    "Arabian Standard Time": "Asia/Dubai",
+    "Arabic Standard Time": "Asia/Baghdad",
+    "Argentina Standard Time": "America/Buenos_Aires",
+    "Astrakhan Standard Time": "Europe/Astrakhan",
+    "Atlantic Standard Time": "America/Halifax",
+    "AUS Central Standard Time": "Australia/Darwin",
+    "Aus Central W. Standard Time": "Australia/Eucla",
+    "AUS Eastern Standard Time": "Australia/Sydney",
+    "Azerbaijan Standard Time": "Asia/Baku",
+    "Azores Standard Time": "Atlantic/Azores",
+    "Bahia Standard Time": "America/Bahia",
+    "Bangladesh Standard Time": "Asia/Dhaka",
+    "Belarus Standard Time": "Europe/Minsk",
+    "Bougainville Standard Time": "Pacific/Bougainville",
+    "British Columbia Standard Time": "America/Vancouver",
+    "Canada Central Standard Time": "America/Regina",
+    "Cape Verde Standard Time": "Atlantic/Cape_Verde",
+    "Caucasus Standard Time": "Asia/Yerevan",
+    "Cen. Australia Standard Time": "Australia/Adelaide",
+    "Central America Standard Time": "America/Guatemala",
+    "Central Asia Standard Time": "Asia/Bishkek",
+    "Central Brazilian Standard Time": "America/Cuiaba",
+    "Central Europe Standard Time": "Europe/Budapest",
+    "Central European Standard Time": "Europe/Warsaw",
+    "Central Pacific Standard Time": "Pacific/Guadalcanal",
+    "Central Standard Time": "America/Chicago",
+    "Central Standard Time (Mexico)": "America/Mexico_City",
+    "Chatham Islands Standard Time": "Pacific/Chatham",
+    "China Standard Time": "Asia/Shanghai",
+    "Cuba Standard Time": "America/Havana",
+    "Dateline Standard Time": "Etc/GMT+12",
+    "E. Africa Standard Time": "Africa/Nairobi",
+    "E. Australia Standard Time": "Australia/Brisbane",
+    "E. Europe Standard Time": "Europe/Chisinau",
+    "E. South America Standard Time": "America/Sao_Paulo",
+    "Easter Island Standard Time": "Pacific/Easter",
+    "Eastern Standard Time": "America/New_York",
+    "Eastern Standard Time (Mexico)": "America/Cancun",
+    "Egypt Standard Time": "Africa/Cairo",
+    "Ekaterinburg Standard Time": "Asia/Yekaterinburg",
+    "Fiji Standard Time": "Pacific/Fiji",
+    "FLE Standard Time": "Europe/Kiev",
+    "Georgian Standard Time": "Asia/Tbilisi",
+    "GMT Standard Time": "Europe/London",
+    "Greenland Standard Time": "America/Godthab",
+    "Greenwich Standard Time": "Atlantic/Reykjavik",
+    "GTB Standard Time": "Europe/Bucharest",
+    "Haiti Standard Time": "America/Port-au-Prince",
+    "Hawaiian Standard Time": "Pacific/Honolulu",
+    "India Standard Time": "Asia/Calcutta",
+    "Iran Standard Time": "Asia/Tehran",
+    "Israel Standard Time": "Asia/Jerusalem",
+    "Jordan Standard Time": "Asia/Amman",
+    "Kaliningrad Standard Time": "Europe/Kaliningrad",
+    "Korea Standard Time": "Asia/Seoul",
+    "Libya Standard Time": "Africa/Tripoli",
+    "Line Islands Standard Time": "Pacific/Kiritimati",
+    "Lord Howe Standard Time": "Australia/Lord_Howe",
+    "Magadan Standard Time": "Asia/Magadan",
+    "Magallanes Standard Time": "America/Punta_Arenas",
+    "Manitoba Standard Time": "America/Winnipeg",
+    "Marquesas Standard Time": "Pacific/Marquesas",
+    "Mauritius Standard Time": "Indian/Mauritius",
+    "Middle East Standard Time": "Asia/Beirut",
+    "Montevideo Standard Time": "America/Montevideo",
+    "Morocco Standard Time": "Africa/Casablanca",
+    "Mountain Standard Time": "America/Denver",
+    "Mountain Standard Time (Mexico)": "America/Mazatlan",
+    "Myanmar Standard Time": "Asia/Rangoon",
+    "N. Central Asia Standard Time": "Asia/Novosibirsk",
+    "Namibia Standard Time": "Africa/Windhoek",
+    "Nepal Standard Time": "Asia/Katmandu",
+    "New Zealand Standard Time": "Pacific/Auckland",
+    "Newfoundland Standard Time": "America/St_Johns",
+    "Norfolk Standard Time": "Pacific/Norfolk",
+    "North Asia East Standard Time": "Asia/Irkutsk",
+    "North Asia Standard Time": "Asia/Krasnoyarsk",
+    "North Korea Standard Time": "Asia/Pyongyang",
+    "Omsk Standard Time": "Asia/Omsk",
+    "Pacific SA Standard Time": "America/Santiago",
+    "Pacific Standard Time": "America/Los_Angeles",
+    "Pacific Standard Time (Mexico)": "America/Tijuana",
+    "Pakistan Standard Time": "Asia/Karachi",
+    "Paraguay Standard Time": "America/Asuncion",
+    "Qyzylorda Standard Time": "Asia/Qyzylorda",
+    "Romance Standard Time": "Europe/Paris",
+    "Russia Time Zone 10": "Asia/Srednekolymsk",
+    "Russia Time Zone 11": "Asia/Kamchatka",
+    "Russia Time Zone 3": "Europe/Samara",
+    "Russian Standard Time": "Europe/Moscow",
+    "SA Eastern Standard Time": "America/Cayenne",
+    "SA Pacific Standard Time": "America/Bogota",
+    "SA Western Standard Time": "America/La_Paz",
+    "Saint Pierre Standard Time": "America/Miquelon",
+    "Sakhalin Standard Time": "Asia/Sakhalin",
+    "Samoa Standard Time": "Pacific/Apia",
+    "Sao Tome Standard Time": "Africa/Sao_Tome",
+    "Saratov Standard Time": "Europe/Saratov",
+    "SE Asia Standard Time": "Asia/Bangkok",
+    "Singapore Standard Time": "Asia/Singapore",
+    "South Africa Standard Time": "Africa/Johannesburg",
+    "South Sudan Standard Time": "Africa/Juba",
+    "Sri Lanka Standard Time": "Asia/Colombo",
+    "Sudan Standard Time": "Africa/Khartoum",
+    "Syria Standard Time": "Asia/Damascus",
+    "Taipei Standard Time": "Asia/Taipei",
+    "Tasmania Standard Time": "Australia/Hobart",
+    "Tocantins Standard Time": "America/Araguaina",
+    "Tokyo Standard Time": "Asia/Tokyo",
+    "Tomsk Standard Time": "Asia/Tomsk",
+    "Tonga Standard Time": "Pacific/Tongatapu",
+    "Transbaikal Standard Time": "Asia/Chita",
+    "Turkey Standard Time": "Europe/Istanbul",
+    "Turks And Caicos Standard Time": "America/Grand_Turk",
+    "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar",
+    "US Eastern Standard Time": "America/Indianapolis",
+    "US Mountain Standard Time": "America/Phoenix",
+    UTC: "Etc/UTC",
+    "UTC-02": "Etc/GMT+2",
+    "UTC-08": "Etc/GMT+8",
+    "UTC-09": "Etc/GMT+9",
+    "UTC-11": "Etc/GMT+11",
+    "UTC+12": "Etc/GMT-12",
+    "UTC+13": "Etc/GMT-13",
+    "Venezuela Standard Time": "America/Caracas",
+    "Vladivostok Standard Time": "Asia/Vladivostok",
+    "Volgograd Standard Time": "Europe/Volgograd",
+    "W. Australia Standard Time": "Australia/Perth",
+    "W. Central Africa Standard Time": "Africa/Lagos",
+    "W. Europe Standard Time": "Europe/Berlin",
+    "W. Mongolia Standard Time": "Asia/Hovd",
+    "West Asia Standard Time": "Asia/Tashkent",
+    "West Bank Standard Time": "Asia/Hebron",
+    "West Pacific Standard Time": "Pacific/Port_Moresby",
+    "Yakutsk Standard Time": "Asia/Yakutsk",
+    "Yukon Standard Time": "America/Whitehorse",
+};

package/dist/cli/compact.js

@@ -2,6 +2,7 @@ import { visibleControls } from "@wirecat/cli-base";
 import { metaOf } from "@wirecat/cli-base/commands";
 import { ENTITIES } from "../entities/index.js";
 import { answerRow } from "./answer-entity.js";
+import { STATUS_ROWS } from "./project-status-rows.js";
 export const TEXT_CHARS = 400;
 const sender = { field: ["sender_is_me", "sender_name"], tag: "me" };
 const messageRow = {
@@ -39,6 +40,7 @@ export const SHARED_ROWS = {
             { field: "last_message_at", as: "time" },
         ],
     },
+    ...STATUS_ROWS,
 };
 /** Any record: what names it, what it is called, what state it is in, then what it says. */
 export const GENERIC_ROW = {

package/dist/cli/index.d.ts

@@ -111,10 +111,13 @@ export { type Saving, stored } from "./messenger/stored.js";
 export { dateOrNone } from "./messenger/tasks-command.js";
 export { MODEL_CATALOGUE_QUERY, type ModelCatalogueOptions } from "./model-catalogue-command.js";
 export { positiveCount, window, withPaging } from "./paging.js";
+export { PAYMENT_QUERY_FIELDS, paymentFilterOf } from "./payment-query.js";
 export { type CommandPermissions, commandPathKey, commandPermissions, knownBeside, knownPermissionKeys, type PermissionKeyOf, type PermissionKeySource, refuseUnknownPermissionKeys, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
 export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, type ProgramDefinition, type ProgramOptions, type RunOptions, run } from "./program.js";
 export { type ProjectTextHints, projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, withSyncCommands, } from "./project-evidence.js";
+export { type ProjectStatusHints, type ProjectStatusItem, projectStatusAnswer, projectStatusRow, projectStatusSchema, projectStatusText, } from "./project-status.js";
+export { STATUS_ROWS, STATUS_SIGNAL_ROWS } from "./project-status-rows.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export type { ScheduleHost } from "./schedule/schedule-command.js";
 export { type Config, type Configuration, count, first, flag, fromFile, type GlobalFlags, NONE_NAMED, namedProfile, type ProfileKind, plain, type ResolveOptions, type Settings, type SettingsExtension, type SettingsExtensionContext, type Source, settingsFor, } from "./settings.js";

package/dist/cli/index.js

@@ -101,10 +101,13 @@ export { stored } from "./messenger/stored.js";
 export { dateOrNone } from "./messenger/tasks-command.js";
 export { MODEL_CATALOGUE_QUERY } from "./model-catalogue-command.js";
 export { positiveCount, window, withPaging } from "./paging.js";
+export { PAYMENT_QUERY_FIELDS, paymentFilterOf } from "./payment-query.js";
 export { commandPathKey, commandPermissions, knownBeside, knownPermissionKeys, refuseUnknownPermissionKeys, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
 export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, run } from "./program.js";
 export { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWindowOf, withSyncCommands, } from "./project-evidence.js";
+export { projectStatusAnswer, projectStatusRow, projectStatusSchema, projectStatusText, } from "./project-status.js";
+export { STATUS_ROWS, STATUS_SIGNAL_ROWS } from "./project-status-rows.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export { count, first, flag, fromFile, NONE_NAMED, namedProfile, plain, settingsFor, } from "./settings.js";
 export { readSetupAnswers, setupPermissionCeiling } from "./setup-answers.js";

package/dist/cli/meeting-findings-input.js

@@ -17,7 +17,8 @@ const parseFindingsJson = (text, label, validate) => {
     catch {
         throw new CliError("validation_error", `${label} input must be valid JSON`);
     }
-    const decode = (value, depth = 0) => {
+    // A payment keeps its snake_case fields: it is stored and printed as written.
+    const decode = (value, depth = 0, verbatim = false) => {
         if (depth > 16)
             throw new CliError("validation_error", `${label} JSON is nested too deeply`);
         if (Array.isArray(value))
@@ -28,10 +29,10 @@ const parseFindingsJson = (text, label, validate) => {
         for (const [key, item] of Object.entries(value)) {
             if (/[A-Z]/.test(key))
                 throw new CliError("validation_error", `${label} JSON fields use snake_case`);
-            const name = keys[key] ?? key;
+            const name = verbatim ? key : (keys[key] ?? key);
             if (Object.hasOwn(output, name))
                 throw new CliError("validation_error", `duplicate ${label} field`);
-            Object.defineProperty(output, name, { value: decode(item, depth + 1), enumerable: true });
+            Object.defineProperty(output, name, { value: decode(item, depth + 1, key === "payment"), enumerable: true });
         }
         return output;
     };

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

@@ -33,6 +33,21 @@ import { stopOnSignal } from "./patience.js";
 const ALL_SINCE = "90d";
 /** What a background `--all` job is listed under; no chat argument is spelled like it. */
 const ALL_CHATS = "--all";
+/** Says where the history limits (history_* settings) stopped the read, so an agent does not take it for all. */
+const limitedLine = (result, status) => {
+    if ("items" in result) {
+        const { groupTooLarge = 0, olderThanWindow = 0 } = result.limited ?? {};
+        if (groupTooLarge + olderThanWindow === 0)
+            return undefined;
+        return (`the history limits (history_* settings) left ${groupTooLarge} big group(s) unread and read ${olderThanWindow} ` +
+            `chat(s) only to the window's start — \`${status}\` lists them; \`messages sync <chat> --full-history\` reads one in full`);
+    }
+    if (result.limited === "group_too_large")
+        return "not read: a group above history_group_members_max — `--full-history` reads it and keeps it in full";
+    if (result.limited === "older_than_window")
+        return "read to the history window's start (history_dialog_days / history_group_days) — `--full-history` reads further";
+    return undefined;
+};
 export const syncCommand = (messenger) => {
     const fetching = messenger.fetching ?? FETCHING;
     return annotate(new Command("sync"), {
@@ -58,7 +73,7 @@ export const syncCommand = (messenger) => {
         .option("--catch-up-chunks <n>", "at most this many local vector chunks", wholeNumber)
         .option("--catch-up-messages <n>", "skip a graph rebuild larger than this many messages", wholeNumber)
         .option("--catch-up-time <duration>", "local preparation time budget, 30s by default")
-        .option("--full-history", "keep this chat's pushed history in full from now on, past the history limits (history_* settings)")
+        .option("--full-history", "read and keep this chat's history in full from now on, past the history limits (history_* settings)")
         .option("--background", "run as a job that outlives this command; `store jobs show` follows it")
         .option("--dry-run", "only estimate how many messages, requests and minutes a full fetch would still take — from the store, no request")
         .action(async function (chat) {
@@ -151,6 +166,7 @@ export const syncCommand = (messenger) => {
                 limit,
                 pageSize,
                 pauseMs,
+                ...(include ? { fullHistory: true } : {}),
                 catchUp: prepare ? preparation : false,
                 ...(sinceMs === undefined ? {} : { sinceMs }),
                 ...(last === undefined ? {} : { last }),
@@ -191,9 +207,20 @@ export const syncCommand = (messenger) => {
                         ]
                         : []),
                     ...(toReview > 0 ? [nextStep("mentions.review", { args: { new: true }, values: { shown } })] : []),
+                    ...("limited" in result && result.limited && "chat" in result && result.chat
+                        ? [
+                            {
+                                ...nextStep("messages.sync", { args: { chat: result.chat, full_history: true } }),
+                                why: "reads this chat past the history limits and keeps it in full from now on",
+                            },
+                        ]
+                        : []),
                 ],
                 meta: window.meta,
             }));
+            const limitedNote = limitedLine(result, lineOf(this, "store status"));
+            if (limitedNote)
+                context.renderer.note(limitedNote);
             if (tasks?.held)
                 context.renderer.note(`the first sync left ${tasks.held} possible task(s) in ${tasks.heldChats ?? 0} chat(s) unopened ` +
                     `(config task_first_pass_per_chat) — ask the owner, then \`${lineOf(this, "tasks scan <chat>")}\``);

package/dist/cli/messenger/context.js

@@ -422,6 +422,7 @@ export const messengerContext = (command, messenger, resolving = {}) => {
                 // Turning recording off by name (--no-record, or record: false) keeps no search history either.
                 history: base.settings.record,
                 searchCatchUp: base.settings.searchCatchUp,
+                ...(base.settings.historyLimits ? { historyLimits: base.settings.historyLimits } : {}),
                 pictures: base.settings.pictureSearch,
                 reranker: base.settings.searchReranker,
                 guard,

package/dist/cli/messenger/history-gaps.js

@@ -1,7 +1,7 @@
 import { nextStep } from "../steps.js";
 const SHOWN = 5;
 const reasonOf = (skip) => skip.reason === "group_too_large"
-    ? `a group of ${skip.members ?? "many"} people, not saved`
+    ? `a group of ${skip.members ?? "many"} people, not ${skip.unread ? "read" : "saved"}`
     : `only from ${skip.keptFrom?.slice(0, 10) ?? "the window's start"}`;
 const nameOf = (skip) => skip.title ?? skip.chatId;
 /**
@@ -15,7 +15,7 @@ export const historyLimitGaps = (skips) => {
     const messages = skips.reduce((sum, skip) => sum + skip.messages, 0);
     const listed = skips
         .slice(0, SHOWN)
-        .map((skip) => `${nameOf(skip)} (${skip.messages}, ${reasonOf(skip)})`)
+        .map((skip) => `${nameOf(skip)} (${skip.messages > 0 ? `${skip.messages}, ` : ""}${reasonOf(skip)})`)
         .join("; ");
     const more = skips.length > SHOWN ? `; and ${skips.length - SHOWN} more — \`store status\` lists them` : "";
     return {
@@ -28,8 +28,8 @@ export const historyLimitGaps = (skips) => {
         missing: [
             {
                 field: "history_limits",
-                why: `the history limits (history_* settings) left ${messages} pushed messages of ${skips.length} chats out of ` +
-                    `the store: ${listed}${more}`,
+                why: `the history limits (history_* settings) left history of ${skips.length} chats out of the store` +
+                    `${messages > 0 ? ` (${messages} pushed messages counted)` : ""}: ${listed}${more}`,
                 step: "messages.sync",
             },
         ],

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

@@ -355,6 +355,7 @@ const serveProfiles = async (self, context, host, flags, set) => {
             tokenFile,
             lockFile: httpLockFile(tokenFile),
             version: app.version,
+            reaches: app.messenger === false ? `your ${host.name}` : "your messages",
             onCode: (code, expires) => context.renderer.note(env[mcpHttpMarker(app.envPrefix)] === undefined
                 ? `login code for a new browser app: ${code} (until ${expires.toTimeString().slice(0, 5)}; a new one after each login)`
                 : `a new login code for a browser app: \`${app.command} mcp server status --profiles ${set.option}\``),