@wirecat/cli-core 0.397.0 → 0.398.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ 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.
 
+## 0.398.0 — 23.10.2026
+
+### Added
+
+- Top-level summaries, listeners and shell completion include examples in help and command discovery.
+
+- Clearing a remembered flood hold includes an example in help and command discovery.
+
+- **`Messenger.never`**: the adapter methods a messenger can never have, as opposed to `lacks`, what it does not have
+  yet. Their commands refuse as before and are also left out of help, `commands --json` and MCP. A command a
+  messenger only `lacks` stays in sight. For WhatsApp: `endOtherSessions` (only the phone ends other devices) and
+  `removeContact`.
+
+- **`review --offline` reads the local store** instead of refusing, for every messenger. It shows only what was
+  already synced and says so (`missing` in JSON, a warning on the terminal); its next step starts from the same
+  point, and `--new` keeps its saved point, so an online review still sees what was never synced.
+
+- **MCP offers more commands**, each limited by the profile's permissions: `runs list|show|path`, `store status|info|check|export|reindex`,
+  `store jobs cancel|retry|clear`, `attachments move`, `attachments jobs status`, `config show`, `commands schema`, `guide`,
+  `skill show`, `doctor report`, the `models` lists, `replies status|test|consents show`, `schedule list`,
+  `server status|logs`, and on the bot server `list`, `chats leave`, `chats admins add|remove`, `commands set|clear` and
+  `webhooks list|set|delete`. What stays off and why is in [the messenger rules](docs/dev/STANDARD.md#mcp).
+
+### Security
+
+- `@modelcontextprotocol/server` 2.3.0 clears the three high-severity advisories `npm audit` reported for every
+  WireCat CLI.
+
+### Fixed
+
+- **A pasted help example runs.** The `Example:` line of an account command's `--help`, generated or written, names
+  the profile `personal` (`tg personal messages list Team`), so it no longer fails with "name a profile".
+
+- `search mail` with no mail in the store points at `memo sync --only mail`; it named a `--mail` option memo does not have.
+
+- `parity.json` matches tg and max: `guide`, `mentions`, `runs search`, `tasks reject` and `--brief`/`--full` are in
+  both, and each gap planned for tg names its tg-cli backlog id.
+
+- `search all --help` says the messenger's server is asked by default and names `--backend archive` and `--offline`
+  to keep it to the local store.
+
 ## 0.397.0 — 23.10.2026
 
 ### Changed — may break callers

package/README.md

@@ -4,7 +4,8 @@
 
 # @wirecat/cli-core
 
-The engine behind the WireCat command-line tools for Telegram, MAX, mail, notes and meetings. Everything that
+The engine behind the WireCat command-line tools for Telegram, MAX, WhatsApp, mail, notes, meetings and Google
+Drive. Everything that
 does not depend on one messenger lives here: the data model, a local SQLite store with full-text and semantic
 search, a Lucene query language, the shared commands, an MCP server for AI agents, and the guard around every
 write. A messenger plugs in as one adapter and gets all of it.
@@ -36,6 +37,7 @@ write. A messenger plugs in as one adapter and gets all of it.
 | [Testing](docs/dev/TESTING.md) · [Parity audit](docs/dev/PARITY-AUDIT.md) | The sandbox, the coverage floor, the checks across tg and max |
 | [Tool boundaries](docs/dev/TOOL-BOUNDARIES.md) | Which tool owns which command |
 | [API reference](docs/REFERENCE.md) | Every entry point and the detailed contract of each feature |
+| [Roadmap](docs/roadmap.md) | What is being built next for developers on this package |
 | [Changelog](CHANGELOG.md) | What each version changed, and what may break callers |
 
 ## What it is
@@ -72,7 +74,7 @@ It runs on Node 22.16+ and 24+, and on Bun.
 
 ```mermaid
 flowchart TB
-  tools["tg · max · memo · zm · drive"] --> interface
+  tools["tg · max · wa · memo · zm · drive"] --> interface
   subgraph core ["@wirecat/cli-core"]
     interface["Interface: CLI commands and MCP tools"] --> services["Services: one use case each"]
     services --> ports["Ports: MessengerAdapter · MeetingSource · TaskStore"]
@@ -88,7 +90,7 @@ Five layers, and each calls only the layers below it: domain, adapters behind a
 
 - **The CLI and the MCP server are two adapters over the same services.** A command and its MCP tool answer with
   the same data, because one service produces it.
-- **A port with one required core and optional groups.** `MessengerCore` is what every messenger must do. Seventeen
+- **A port with one required core and optional groups.** `MessengerCore` is what every messenger must do. The other
   groups — server reads, polls, forums, reactions and the rest — are optional and reached through `capability()`.
   A messenger without a group refuses the command before connecting; it never crashes and never silently drops an
   option.
@@ -116,8 +118,9 @@ code and its document must agree. A search plan that reads an index once per mes
 - **One query language for every list and every source.** A TypeScript port of the Apache Lucene 9.12.3 parsers,
   with no runtime parser dependency. Phrases, `AND` / `OR` / `NOT`, `+required`, grouping, field groups like
   `from:(alice OR bob)`, ranges `date:[2026-01-01 TO 2026-02-01}`, comparisons `size>10MB`, wildcards and regular
-  expressions. 27 fields: sender, chat, date, file name, MIME type, transcript, subject, label and more. Fuzzy
-  and proximity operators are refused with an error that names the alternative.
+  expressions. 27 fields: sender, chat, date, file name, MIME type, transcript, subject, label and more.
+  Proximity `"invoice paid"~3` finds the words close together in one message; the fuzzy operator `word~1` is
+  refused with an error that names the alternative.
   [Syntax](docs/search/query-language.md) · [grammar](docs/search/query-language-spec.md)
 - **Any three letters inside a word.** An FTS5 trigram index finds `port` inside `report`. A
   second, word index ranks by BM25.
@@ -211,8 +214,9 @@ they deliberately differ. A rule changes in its own pull request, before the cod
 - **Built for agents.** `--no-input` never prompts. Input and output are bounded (16 MiB in, 4 MiB out) and fail
   visibly instead of truncating. One-shot commands time out after 30 seconds and close what they hold. `--dry-run`
   previews any write.
-- **The tool never picks an account.** The profile is the first word of every account command; without one, the
-  command stops and lists the choices — even when there is only one.
+- **The tool never picks an account.** Every account command names its profile — the first word in tg, max and
+  wa, an option such as `--account` or `--profile` in the others; without one, the command stops and lists the
+  choices — even when there is only one.
 - **Run records keep ids and timings, never content.** A failure is kept by default, so `runs show` can explain it
   without anyone sending a log full of messages.
 - **Tests that cannot touch real data.** A sandbox keeps every test away from the owner's store, and no test may
@@ -253,8 +257,7 @@ describe("the adapter keeps the port's promises", () => {
 **Before 1.0, any release may break a caller.** Releases are frequent, sometimes several a day, and any of them
 may change any entry point. Every such change is listed in the [changelog](CHANGELOG.md) under "Changed — may break
 callers", with what to change. tg-cli and max-cli pin an exact version and move to a new one in their own pull request.
-Pin an exact version too: as of 18.10.2026, 132 of the 321 versions in the changelog break callers, and no patch
-release has.
+Pin an exact version too.
 The full list of entry points and what each holds is in the [API reference](docs/REFERENCE.md).
 
 ⚠ **Errors are recognised by shape, not by class** (`isCliFailure`). A package linked during development brings its

package/dist/cli/bot/admins.js

@@ -35,7 +35,7 @@ export const botAdminsCommand = (bot) => {
             renderAnswer(this, context, wholeList("bot chats admins list", admins.map(snakeKeys)));
         });
     });
-    annotate(command.command("add"), { effects: REMOTE_WRITE, mcp: false })
+    annotate(command.command("add"), { effects: REMOTE_WRITE })
         .description("make a member an admin with these rights")
         .argument("<chat>", CHAT)
         .argument("<person>", PERSON)
@@ -61,7 +61,7 @@ export const botAdminsCommand = (bot) => {
             });
         });
     });
-    annotate(command.command("remove"), { effects: REMOTE_WRITE, mcp: false })
+    annotate(command.command("remove"), { effects: REMOTE_WRITE })
         .description("take an admin's rights back; they stay a member")
         .argument("<chat>", CHAT)
         .argument("<person>", PERSON)

package/dist/cli/bot/command.js

@@ -111,7 +111,7 @@ const meCommand = (bot) => annotate(new Command("me"), { effects: REMOTE_READ })
         }
     });
 });
-const listCommand = (bot, tokenVariable) => annotate(new Command("list"), { effects: LOCAL_READ, mcp: false })
+const listCommand = (bot, tokenVariable) => annotate(new Command("list"), { effects: LOCAL_READ })
     .description(`every name on this machine that has a bot token; --check asks ${bot.name ?? "the messenger"} which bot each is`)
     .option("--check", "ask the messenger who each bot is, with its token")
     .action(async function () {
@@ -216,7 +216,7 @@ const chatsCommand = (bot) => {
             renderItem(this, context, found);
         });
     });
-    annotate(command.command("leave"), { effects: REMOTE_WRITE, mcp: false })
+    annotate(command.command("leave"), { effects: REMOTE_WRITE })
         .description("take the bot out of a chat; only an admin of the chat can bring it back")
         .argument("<chat>", "a chat id, or the title of a chat this bot has seen")
         .action(async function (chat) {

package/dist/cli/bot/setup.js

@@ -48,13 +48,13 @@ export const botMenuCommand = (bot) => {
             renderAnswer(command, context, wholeList("bot commands list", entries));
         });
     };
-    annotate(command.command("set"), { effects: REMOTE_WRITE, mcp: false })
+    annotate(command.command("set"), { effects: REMOTE_WRITE })
         .description("replace the whole menu: each command as name=description, e.g. start=Begin")
         .argument("<commands...>", "name=description, one per command")
         .action(async function (typed) {
         await replace(this, typed.map(entryOf), "bot.commands.set");
     });
-    annotate(command.command("clear"), { effects: REMOTE_WRITE, mcp: false })
+    annotate(command.command("clear"), { effects: REMOTE_WRITE })
         .description("empty the menu")
         .action(async function () {
         await replace(this, [], "bot.commands.clear");
@@ -97,7 +97,7 @@ export const botCallbacksCommand = (bot) => new Command("callbacks").description
 }));
 /** `bot webhooks`: where the messenger pushes this bot's updates instead of being polled. */
 export const botWebhooksCommand = (bot) => {
-    const command = annotate(new Command("webhooks"), { mcp: false }).description("where the messenger pushes this bot's updates — while one is set, `bot watch` gets nothing");
+    const command = new Command("webhooks").description("where the messenger pushes this bot's updates — while one is set, `bot watch` gets nothing");
     annotate(command.command("list"), { effects: REMOTE_READ })
         .description("the webhooks this bot has")
         .action(async function () {

package/dist/cli/commands-command.js

@@ -50,7 +50,7 @@ export const commandsCommand = (app) => {
             exit_codes: { ok: 0, [CRASH_CODE]: GENERIC_FAILURE, ...EXIT_CODES },
         });
     });
-    command.addCommand(annotate(new Command("schema"), { effects: NO_EFFECTS, mcp: false })
+    command.addCommand(annotate(new Command("schema"), { effects: NO_EFFECTS })
         .description("one command's argv and result schemas, effects, permissions and retry guidance")
         .argument("<path...>", "one command path, for example: stats messages show")
         .action(function (path) {

package/dist/cli/config-command.js

@@ -15,7 +15,7 @@ import { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } fro
  * configuration accepts can hold a secret — the schema has nowhere to put one.
  */
 export const configCommand = (app, config, { permissionKey } = {}) => {
-    const command = annotate(new Command("config"), { mcp: false }).description("the settings in force, and where each one came from");
+    const command = new Command("config").description("the settings in force, and where each one came from");
     annotate(command.command("show"), { effects: LOCAL_READ, examples: [`${app.command} personal config show`] })
         .description("the profile, the profiles that exist, and each setting with where it came from")
         .option("--bot", "the settings a bot command on this profile gets, rather than the personal account's")

package/dist/cli/guide.js

@@ -116,7 +116,6 @@ const scenarioText = (cli, scenario, profile) => [
 export const guideCommand = (app, options) => {
     const command = annotate(new Command("guide"), {
         effects: NO_EFFECTS,
-        mcp: false,
         examples: [`${app.command} guide`, `${app.command} guide <name> --json`],
     })
         .description("scenarios: the commands for a common task, in order, and why each")

package/dist/cli/help/command-help.d.ts

@@ -7,6 +7,8 @@ export interface NextChoice {
 }
 /** Overrides the "Next usually" a command's help derives from types. Kept off `annotate`, like its section. */
 export declare const nextUsually: <T extends Command>(command: T, choice: NextChoice) => T;
+/** The profile an example names, so a pasted one runs; the name the first screen's "Start here" uses. */
+export declare const EXAMPLE_PROFILE = "personal";
 export interface CommandHelp {
     returns: string;
     next: readonly string[];
@@ -20,8 +22,13 @@ export declare const commandHelp: (command: Command) => CommandHelp;
 export declare const commandHelpText: (command: Command) => string;
 /** The same, as Markdown lines for `docs/commands.md`: hand it to cli-base's `commandsPage` per command. */
 export declare const commandHelpMarkdown: (root: Command, path: readonly string[]) => string[];
-/** Puts Returns, Next usually and Example on every leaf command's `--help`, worked out when the help is shown. */
-export declare const installCommandHelp: (program: Command) => void;
+/**
+ * Puts Returns, Next usually and Example on every leaf command's `--help`, worked out when the help is shown.
+ * With `profile`, an example of an account command gets the profile word it would fail without.
+ */
+export declare const installCommandHelp: (program: Command, { profile }?: {
+    profile?: boolean;
+}) => void;
 /** Which leaf commands still show a generated example, so the important ones get a written one. Report only. */
 export declare const exampleReport: (program: Command) => {
     written: string[];

package/dist/cli/help/command-help.js

@@ -1,6 +1,7 @@
 import { metaOf } from "@wirecat/cli-base/commands";
 import { writes } from "@wirecat/cli-base/standards";
 import { commandPathOf, outputOf } from "../command-contract.js";
+import { PROFILE_FREE } from "../profile.js";
 import { commandAt } from "../steps.js";
 import { short } from "./commands-text.js";
 /** Argument names onto the kinds `domain/references.ts` names; a plural takes the same kind. */
@@ -164,16 +165,28 @@ const generatedExample = (command) => {
             return [flag];
         return [flag, option.argChoices?.[0] ?? sample(placeholder ?? option.attributeName())];
     });
-    // No profile word, as on the first screen and in written examples: the Usage line already shows `<profile>`.
     return [rootOf(command).name(), ...commandPathOf(command), ...words, ...options].join(" ");
 };
+const profiled = new WeakSet();
+/** The profile an example names, so a pasted one runs; the name the first screen's "Start here" uses. */
+export const EXAMPLE_PROFILE = "personal";
+const withProfile = (command, example) => {
+    const root = rootOf(command);
+    const top = commandPathOf(command)[0];
+    if (!profiled.has(root) || top === undefined || PROFILE_FREE.has(top))
+        return example;
+    const prefix = `${root.name()} ${top}`;
+    return example === prefix || example.startsWith(`${prefix} `)
+        ? `${root.name()} ${EXAMPLE_PROFILE} ${example.slice(root.name().length + 1)}`
+        : example;
+};
 /** Returns, Next usually and Example for one command, from its definition alone. */
 export const commandHelp = (command) => {
     const written = metaOf(command).examples ?? [];
     return {
         returns: returnsOf(command),
         next: nextOf(command).map(call),
-        examples: written.length > 0 ? written : [generatedExample(command)],
+        examples: (written.length > 0 ? written : [generatedExample(command)]).map((one) => withProfile(command, one)),
         origin: written.length > 0 ? "written" : "generated",
     };
 };
@@ -197,8 +210,13 @@ export const commandHelpMarkdown = (root, path) => {
         `**Example:** ${code(examples)}`,
     ];
 };
-/** Puts Returns, Next usually and Example on every leaf command's `--help`, worked out when the help is shown. */
-export const installCommandHelp = (program) => {
+/**
+ * Puts Returns, Next usually and Example on every leaf command's `--help`, worked out when the help is shown.
+ * With `profile`, an example of an account command gets the profile word it would fail without.
+ */
+export const installCommandHelp = (program, { profile = true } = {}) => {
+    if (profile)
+        profiled.add(program);
     for (const command of leaves(program))
         command.addHelpText("after", () => commandHelpText(command));
 };

package/dist/cli/help/first-screen.js

@@ -4,7 +4,7 @@ import { Command, Help, Option } from "commander";
 import wrapAnsi from "wrap-ansi";
 import { NO_EFFECTS } from "../effects.js";
 import { commandAt } from "../steps.js";
-import { installCommandHelp } from "./command-help.js";
+import { EXAMPLE_PROFILE, installCommandHelp } from "./command-help.js";
 /** Every WireCat tool, as "Works with" names it; a tool's own entry is left out of its screen. */
 export const WIRECAT_TOOLS = [
     { command: "tg", does: "Telegram in the same local store: search, review and tasks offline" },
@@ -56,7 +56,7 @@ export const firstScreen = (program, screen = {}) => {
     const can = (screen.can ?? []).map(({ command, does }) => [command, does]);
     const works = WIRECAT_TOOLS.filter((tool) => tool.command !== cli).map(({ command, shown, does }) => [shown ?? command, does]);
     const column = Math.max(22, widest([...can, ...works].map(([left]) => left))) + 2;
-    const start = screen.start ?? (commandAt(program, "setup") ? `${cli} personal setup` : undefined);
+    const start = screen.start ?? (commandAt(program, "setup") ? `${cli} ${EXAMPLE_PROFILE} setup` : undefined);
     return [
         wrapAnsi(`${cli} — ${pitch}`, WIDTH),
         "",
@@ -95,7 +95,7 @@ export const installHelp = (program, screen = {}) => {
             ? firstScreen(program, screen)
             : (own.formatHelp ?? Help.prototype.formatHelp).call(helper, command, helper),
     });
-    installCommandHelp(program);
+    installCommandHelp(program, { profile: screen.profile !== false });
     program.addOption(new Option("--help-all", "the full help: every command and option").hideHelp());
     program.on("option:help-all", () => {
         full = true;

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

@@ -12,6 +12,7 @@ import { recalledAccount } from "./accounts.js";
 import { photoHelp, readProfilePhoto } from "./admin-commands.js";
 import { accountAnswer, renderItem, wholeList } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
+import { hideNever } from "./lacks.js";
 import { privacyCommand } from "./records-command.js";
 export const accountCommand = (messenger) => {
     const tool = `${messenger.app.command} personal`;
@@ -80,5 +81,5 @@ export const accountCommand = (messenger) => {
         .addCommand(accountSessionsCommand(messenger));
     if (messenger.privacy === true)
         account.addCommand(privacyCommand(messenger));
-    return account;
+    return hideNever(messenger, account);
 };

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

@@ -64,7 +64,7 @@ export const storeCommand = (messenger) => {
  * What the local store holds, per chat — read from the store alone. Whether a fetch reached a
  * chat's very first message is not recorded, so it is not claimed: the stretches held are shown.
  */
-const statusCommand = (messenger) => annotate(new Command("status"), { effects: LOCAL_READ, mcp: false })
+const statusCommand = (messenger) => annotate(new Command("status"), { effects: LOCAL_READ })
     .summary("what the local archive holds and what is missing")
     .description("per chat: messages stored, the oldest and newest, and the stretches held completely")
     .argument("[chat]", messenger.chatArgument)
@@ -132,7 +132,7 @@ const clearCommand = (messenger) => annotate(new Command("clear"), { effects: LO
  * `--format markdown` for a transcript a person reads. With `--output-dir`, any number of chats into a
  * folder, and each later run into the same folder adds only what changed.
  */
-const exportCommand = (messenger) => destroysNothing(annotate(new Command("export"), { effects: LOCAL_WRITE, mcp: false }))
+const exportCommand = (messenger) => destroysNothing(annotate(new Command("export"), { effects: LOCAL_WRITE }))
     .summary("export stored messages to files")
     .description("a chat's stored messages, oldest first: --jsonl one message per line, --json the list envelope of messages; never asks the messenger")
     .argument("[chat...]", `${messenger.chatArgument}; several with --output-dir`)

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

@@ -237,7 +237,7 @@ export const jobsCommand = (messenger) => {
             : await context.withServices((services) => services.archive.held(chatId)).catch(() => undefined);
         renderAnswer(this, context, itemOf(snakeKeys({ ...jobDetails(job), ...(held ? { held } : {}), log: job.log })));
     });
-    destroysNothing(annotate(command.command("cancel"), { effects: LOCAL_WRITE, mcp: false }))
+    destroysNothing(annotate(command.command("cancel"), { effects: LOCAL_WRITE }))
         .summary("cancel a queued or running archive job")
         .description("stop a running background job after its current page; a later sync resumes where it stopped")
         .argument("<job>", "the job id")
@@ -251,7 +251,7 @@ export const jobsCommand = (messenger) => {
         process.kill(job.pid, "SIGTERM");
         renderAnswer(this, context, itemOf({ job: job.id, cancelled: true }));
     });
-    destroysNothing(annotate(command.command("retry"), { effects: LOCAL_WRITE, mcp: false }))
+    destroysNothing(annotate(command.command("retry"), { effects: LOCAL_WRITE }))
         .summary("retry an archive job")
         .description("start a partial, failed or died job again, as a new job; the sync resumes where the store stopped")
         .argument("[job]", "the job id")
@@ -292,7 +292,7 @@ export const jobsCommand = (messenger) => {
         if (items.length === 0 && context.format === "pretty")
             context.renderer.note("no partial, failed or died jobs to retry");
     });
-    destroysNothing(annotate(command.command("clear"), { effects: LOCAL_WRITE, mcp: false }))
+    destroysNothing(annotate(command.command("clear"), { effects: LOCAL_WRITE }))
         .description("forget finished jobs and remove their logs; a running job is kept")
         .action(function () {
         const context = messengerContext(this, messenger);

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

@@ -49,6 +49,8 @@ export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, r
         }[][] | undefined;
     }[];
 }>;
+/** What `review --offline` cannot see. */
+export declare const OFFLINE_REVIEW = "offline: only what was already synced to the local store; run review without --offline for the rest";
 /**
  * A review the next one goes on from: from `until` when nothing was left out, else from the same start again.
  * Saved points (`--new`) carry this themselves, and an `--unanswered` look is not a review to continue.

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

@@ -48,7 +48,7 @@ const nameOf = (chat) => chat.title ?? chat.id;
  * What every catch-up answer shares: the messages, oldest first, each naming its chat; what was left out as
  * `missing`; and a chat cut short as a `messages.list` step, after the steps the command puts first.
  */
-const catchUpList = (command, found, hearing, reader, { transcribe, first = [], meta = {} }) => {
+const catchUpList = (command, found, hearing, reader, { transcribe, first = [], meta = {}, left = [], }) => {
     const read = found.chats
         .flatMap((chat) => heard(chat.messages, hearing).map((message) => ({ ...message, chatTitle: chat.title })))
         .sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
@@ -70,6 +70,7 @@ const catchUpList = (command, found, hearing, reader, { transcribe, first = [],
             ? [{ field: "items", why: `${found.quiet} muted or archived chats left out`, step: `${command}.all` }]
             : []),
         ...hearingMissing(hearing, transcribe),
+        ...left,
     ];
     return listOf(command, {
         items: read.map((message) => summaryOf(message, reader)),
@@ -81,6 +82,8 @@ const catchUpList = (command, found, hearing, reader, { transcribe, first = [],
     });
 };
 export const inboxAnswer = (inbox, hearing, reader, transcribe, meta = {}) => catchUpList("inbox", inbox, hearing, reader, { transcribe, meta });
+/** What `review --offline` cannot see. */
+export const OFFLINE_REVIEW = "offline: only what was already synced to the local store; run review without --offline for the rest";
 const quoted = (value) => `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
 /**
  * A review the next one goes on from: from `until` when nothing was left out, else from the same start again.
@@ -95,6 +98,7 @@ export const reviewAnswer = (found, hearing, reader, { transcribe, fresh, chat,
     return catchUpList("review", found, hearing, reader, {
         transcribe,
         first: continues ? [nextStep("review.next", { args: { query: query.join(" ") } })] : [],
+        ...(found.offline ? { left: [{ field: "items", why: OFFLINE_REVIEW }] } : {}),
         ...(meta === undefined ? {} : { meta }),
     });
 };

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

@@ -19,6 +19,7 @@ import { membersCommand } from "./chats-members-command.js";
 import { markReadCommand } from "./chats-read-command.js";
 import { trackingCommand } from "./chats-tracking-command.js";
 import { messengerContext } from "./context.js";
+import { hideNever } from "./lacks.js";
 import { archiveCommands, chatDeletionCommands, chatPinCommands, markUnreadCommand, mediaCommand, muteCommands, } from "./records-command.js";
 export const chatsCommand = (messenger) => {
     const chats = new Command("chats").description("the account's chats");
@@ -153,7 +154,7 @@ export const chatsCommand = (messenger) => {
         if (command)
             annotate(command, { examples: [`${messenger.app.command} personal chats ${path} ${args}`.trimEnd()] });
     }
-    return chats;
+    return hideNever(messenger, chats);
 };
 /** Where the history is pushed, the chat list and a chat's card answer from the store and never connect. */
 const storedRead = (messenger) => (messenger.history === "store" ? LOCAL_READ : REMOTE_READ);

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

@@ -19,7 +19,11 @@ const SHELLS = ["zsh", "bash", "fish", "powershell"];
  * ⚠ **A Tab never connects and never creates anything.** Names come from the message store if it
  * exists — no store, no names — and nothing goes to stderr: a shell shows whatever it is given.
  */
-export const completeCommand = (messenger, config, options = {}) => annotate(new Command("complete"), { effects: LOCAL_READ, mcp: false })
+export const completeCommand = (messenger, config, options = {}) => annotate(new Command("complete"), {
+    effects: LOCAL_READ,
+    mcp: false,
+    examples: [`${messenger.app.command} complete zsh`],
+})
     .description(`shell completion: \`${messenger.app.command} complete zsh\` prints the script to source`)
     .argument("[words...]", "zsh for the shell script, or command words to complete")
     .allowUnknownOption()

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

@@ -19,6 +19,7 @@ import { commandAt, nextStep } from "../steps.js";
 import { contactWriteCommands } from "./admin-contacts-command.js";
 import { contactAnswer, lines, pageOf } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
+import { hideNever } from "./lacks.js";
 import { CONTACTS_QUERY, notesAllowed } from "./people-queries.js";
 import { privatePeopleCommands } from "./private-people-command.js";
 import { syncsFirst } from "./search-sync-options.js";
@@ -315,5 +316,5 @@ export const contactsCommand = (messenger) => {
         if (command)
             annotate(command, { examples: [`${messenger.app.command} personal contacts ${path} ${args}`.trimEnd()] });
     }
-    return contacts;
+    return hideNever(messenger, contacts);
 };

package/dist/cli/messenger/context.d.ts

@@ -95,6 +95,11 @@ export interface Messenger extends ServiceMessenger {
      * connecting, as the adapter would refuse after; one connection per device makes that connection a cost.
      */
     lacks?: readonly (keyof MessengerAdapter)[];
+    /**
+     * Adapter methods this messenger can never have, where `lacks` is what it does not have yet: their commands refuse
+     * the same way and are also hidden from help, `commands` and MCP. WhatsApp: only the phone ends other sessions.
+     */
+    never?: readonly (keyof MessengerAdapter)[];
     /** Whether a message can be deleted for the owner alone; yes when unset. No: every delete is for everyone (WhatsApp). */
     deleteForMe?: boolean;
     /** Whether the messenger has forum topics: `--topic`, `topic:` in `messages list` and the `topics_*` tools; yes when unset. */

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

@@ -57,7 +57,7 @@ const INCLUDES = [
 const EXCLUDES = ["message text", "chat titles", "names", "phone numbers", "the session", "the app credentials"];
 const reportCommand = (messenger) => {
     const { app } = messenger;
-    const report = annotate(new Command("report"), { effects: REMOTE_READ, mcp: false })
+    const report = annotate(new Command("report"), { effects: REMOTE_READ })
         .description("what a problem report holds; writes nothing")
         .action(function () {
         const output = outputFor(this);
@@ -74,7 +74,7 @@ const reportCommand = (messenger) => {
             `About a given run:   ${create} --run <id>   (ids: ${lineOf(this, "runs list")})`,
         ].join("\n"));
     });
-    destroysNothing(annotate(report.command("create"), { effects: LOCAL_WRITE }))
+    destroysNothing(annotate(report.command("create"), { effects: LOCAL_WRITE, mcp: false }))
         .description("write a problem report to a file, and say where to send it")
         .option("--run <id>", "the run the report is about; the newest failed one if not given")
         .option("--output <file>", "where to write it; a new file in this directory if not given")

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

@@ -14,7 +14,7 @@ export const floodCommand = (messenger) => {
     const name = messenger.name ?? app.command;
     return annotate(new Command("flood"), { mcp: false })
         .description(`the waits ${name} asked this profile to keep, and a hold on its writes`)
-        .addCommand(grantsAuthority(annotate(new Command("clear"), { effects: LOCAL_WRITE }))
+        .addCommand(grantsAuthority(annotate(new Command("clear"), { effects: LOCAL_WRITE, examples: [`${app.command} personal flood clear`] }))
         .summary("clear a profile's stored rate-limit hold")
         .description(`forget them, lift the hold and the profile's pace, once ${name} no longer limits the account; changes nothing there`)
         .action(async function () {

package/dist/cli/messenger/inbox.js

@@ -29,6 +29,7 @@ export const PARTIAL_NOTE = "the messenger did not list every chat, and did not
  * `date>2h` is a one-off look from a time of your choosing and leaves the points where they were.
  */
 export const inboxCommand = (messenger) => annotate(new Command("inbox"), {
+    examples: [`${messenger.app.command} personal inbox --limit 10`],
     effects: REMOTE_READ,
     output: { entity: "message", view: "summary" },
     query: INBOX_QUERY,

package/dist/cli/messenger/lacks.d.ts

@@ -1,3 +1,4 @@
+import type { Command } from "commander";
 import type { MessengerAdapter } from "../../ports/messenger.js";
 type Need = readonly [method: keyof MessengerAdapter, what: string];
 /**
@@ -9,10 +10,16 @@ export declare const COMMAND_NEEDS: Readonly<Record<string, Need>>;
 interface Lacking {
     channelComments?: boolean;
     lacks?: readonly (keyof MessengerAdapter)[];
+    never?: readonly (keyof MessengerAdapter)[];
     history?: "server" | "store";
 }
 /** The one method this command needs and this messenger never has; none when it has it or the store answers. */
 export declare const lackedNeed: (messenger: Lacking | undefined, path: string) => Need | undefined;
 /** Refuses, before a connection, a command whose one method this messenger never has. */
 export declare const refuseLacking: (messenger: Lacking | undefined, path: readonly string[]) => void;
+/**
+ * Hides under `group` each command whose one method this messenger can `never` have, from help, `commands` and MCP;
+ * typed anyway, it still refuses. A method it only `lacks` keeps its command in sight, since it may come.
+ */
+export declare const hideNever: <T extends Command>(messenger: Lacking, group: T) => T;
 export {};

package/dist/cli/messenger/lacks.js

@@ -32,7 +32,7 @@ export const lackedNeed = (messenger, path) => {
         return undefined;
     if (path === "messages comments" && messenger?.channelComments === false)
         return need;
-    if (!messenger?.lacks?.includes(need[0]))
+    if (!messenger?.lacks?.includes(need[0]) && !messenger?.never?.includes(need[0]))
         return undefined;
     return messenger.history === "store" && STORE_ANSWERS.has(path) ? undefined : need;
 };
@@ -42,3 +42,20 @@ export const refuseLacking = (messenger, path) => {
     if (need)
         throw new CliError("validation_error", `this messenger cannot ${need[1]}`);
 };
+/**
+ * Hides under `group` each command whose one method this messenger can `never` have, from help, `commands` and MCP;
+ * typed anyway, it still refuses. A method it only `lacks` keeps its command in sight, since it may come.
+ */
+export const hideNever = (messenger, group) => {
+    const walk = (command, path) => {
+        for (const child of command.commands) {
+            const at = [...path, child.name()];
+            const need = COMMAND_NEEDS[at.join(" ")];
+            if (need && messenger.never?.includes(need[0]))
+                child._hidden = true;
+            walk(child, at);
+        }
+    };
+    walk(group, [group.name()]);
+    return group;
+};

package/dist/cli/messenger/media-archive-move-command.js

@@ -9,7 +9,6 @@ import { messengerContext, refuseLocalWrite } from "./context.js";
 export const addMediaArchiveMove = (attachments, messenger) => {
     annotate(attachments.command("move"), {
         effects: LOCAL_WRITE,
-        mcp: false,
         examples: [
             `${messenger.app.command} attachments move ./media-archive ./older-images --before-time 2026-10-01T00:00:00Z --dry-run`,
         ],

package/dist/cli/messenger/media-archive-timer-command.js

@@ -11,11 +11,11 @@ import { grantsAuthority, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { messengerContext } from "./context.js";
 export const addMediaArchiveTimers = (attachments, messenger) => {
-    const archive = annotate(attachments.command("jobs"), { mcp: false }).description("daily media archive timers for this profile");
+    const archive = attachments.command("jobs").description("daily media archive timers for this profile");
     for (const action of ["install", "start", "stop", "status", "uninstall"]) {
         const command = annotate(archive.command(action), {
             effects: action === "status" ? LOCAL_READ : LOCAL_WRITE,
-            mcp: false,
+            ...(action === "status" ? {} : { mcp: false }),
             examples: [`${messenger.app.command} attachments jobs ${action} ./media-archive`],
         })
             .description({

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

@@ -17,6 +17,7 @@ import { linksCommand } from "./conversations-command.js";
 import { downloadSubcommand } from "./download-command.js";
 import { heardItems, hearForCommand, hearingMissing, MODEL_OPTION, spokenItems, TRANSCRIBE_OPTION, } from "./hearing-command.js";
 import { cursorOf, historyQuery, historyWindow } from "./history-query.js";
+import { hideNever } from "./lacks.js";
 import { threadAnswer } from "./message-answers.js";
 import { messageItem, messageItems, viewOf } from "./message-items.js";
 import { commentsCommand } from "./messages-comments-command.js";
@@ -174,7 +175,7 @@ export const messagesCommand = (messenger) => {
     messages.addCommand(commentsCommand(messenger));
     messages.addCommand(linksCommand(messenger));
     messages.addCommand(syncCommand(messenger));
-    return messages;
+    return hideNever(messenger, messages);
 };
 /** Mail lives in the mail tables of the store, whichever messenger CLI reads it. */
 const isMailLocator = (chat, message) => message === undefined && isLocator(chat) && parseLocator(chat).provider === "email";