@wirecat/cli-core 0.346.0 → 0.348.0

package/dist/runs/scope.js

@@ -21,6 +21,11 @@ export const currentRun = () => {
     return processScope;
 };
 export const inRun = (scope, body) => scopes.run(scope, body);
+/**
+ * A command as a person types it: `max personal store migrate`. A hint without the profile fails when copied,
+ * since no profile is assumed; outside a run with a profile it stays `max store migrate`.
+ */
+export const typedCommand = (tool, words, profile = currentRun().profile) => [tool, profile, words].filter((part) => part !== undefined && part !== "").join(" ");
 /**
  * For a one-shot command whose action runs outside `inRun` — max's `max bot`, recorded from commander's hooks, which
  * cannot wrap the action — so its answers' `meta.run_id` names the run `runs show` finds. Never in a server.

package/dist/sends/permissions.js

@@ -341,6 +341,8 @@ export const WRITE_KEYS = [
 ];
 /** Commands that look after the tool and its files and never show a message: no level stops them. */
 const HOUSEKEEPING = new Set([
+    "help",
+    "guide",
     "config",
     "session",
     "doctor",

package/dist/services/archive.js

@@ -1,6 +1,7 @@
 import { setTimeout as sleep } from "node:timers/promises";
 import { CliError } from "@wirecat/cli-base";
 import { capability } from "../ports/messenger.js";
+import { typedCommand } from "../runs/scope.js";
 import { fetchedKey, historyStartKey, } from "../store/store.js";
 import { estimateBackfill } from "./backfill-estimate.js";
 import { actionable, batchProgress } from "./batch.js";
@@ -11,7 +12,7 @@ import { catchUpSearch, validateCatchUp } from "./search-catchup.js";
 const pushed = (deps, what) => {
     if (deps.reads === "store") {
         throw new CliError("validation_error", `${what} asks for older history, and this messenger pushes its history instead — keep ` +
-            `\`${deps.messenger.app.command} serve\` running`);
+            `\`${typedCommand(deps.messenger.app.command, "serve")}\` running`);
     }
 };
 /** The most messages a provider hands out per history request — Telegram's cap. */

package/dist/services/chats.js

@@ -4,6 +4,7 @@ import { botCheckService } from "../botcheck/service.js";
 import { threadIdOf } from "../domain/thread.js";
 import { capability } from "../ports/messenger.js";
 import { syncsOneChat } from "../ports/traits.js";
+import { typedCommand } from "../runs/scope.js";
 import { codeOf, guardedWrite } from "../sends/guarded.js";
 import { newOperationId } from "../sends/send-id.js";
 import { CHAT_COLUMNS, queryFilter, } from "../store/store.js";
@@ -147,7 +148,7 @@ export const chatsService = (deps) => ({
         const counted = counts.length > 0 ? { ...known, memberCounts: counts } : known;
         return completeness.state === "complete" || !syncsOneChat(deps.messenger)
             ? counted
-            : { ...counted, fetch: `${deps.messenger.app.command} messages sync ${chatId}` };
+            : { ...counted, fetch: typedCommand(deps.messenger.app.command, `messages sync ${chatId}`) };
     },
     sendAs: async (chat) => {
         if (deps.offline) {
@@ -180,7 +181,7 @@ export const chatsService = (deps) => ({
             unknown,
             ...(stored?.completeness ? { completeness: stored.completeness } : {}),
             ...(stored?.completeness && stored.completeness.state !== "complete" && syncsOneChat(deps.messenger)
-                ? { fetch: `${deps.messenger.app.command} messages sync ${id}` }
+                ? { fetch: typedCommand(deps.messenger.app.command, `messages sync ${id}`) }
                 : {}),
             items,
         };

package/dist/services/conversations.js

@@ -5,6 +5,7 @@ import { linkMessages, RULES_VERSION } from "../conversations/link.js";
 import { formatLocator } from "../domain/locator.js";
 import { formatReference } from "../domain/references.js";
 import { conversation } from "../entities/conversation.js";
+import { typedCommand } from "../runs/scope.js";
 import { CONVERSATION_COLUMNS, queryFilter, } from "../store/store.js";
 import { accountStore } from "./deps.js";
 import { chatIdIn } from "./message-resolution.js";
@@ -38,7 +39,7 @@ export const conversationsService = (deps) => {
         const store = await accountStore(deps);
         return { store, chatId: await chatIdIn(deps.messenger, chat, store) };
     };
-    const notBuilt = (chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${deps.messenger.app.command} conversations build --chat ${chatId}\``);
+    const notBuilt = (chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${typedCommand(deps.messenger.app.command, `conversations build --chat ${chatId}`)}\``);
     return {
         build: async (chat, { maxMessages, check } = {}) => {
             check?.();

package/dist/services/deps.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { isCliFailure } from "../errors/failures.js";
+import { typedCommand } from "../runs/scope.js";
 /** The store with the running account bound: the default for a service's reads and writes. */
 export const accountStore = async (deps) => (await deps.store()).forAccount(await deps.account());
 /**
@@ -49,7 +50,7 @@ export const storeIfOpen = async (deps) => {
 /** Whether `chats`, `messages list|context` and `contacts` answer from the store instead of the messenger. */
 export const fromStore = (deps) => deps.offline || deps.reads === "store";
 /** What a store-mode read answers for a chat the store holds nothing of. */
-export const nothingStored = (messenger) => `nothing stored for this chat yet — keep \`${messenger.app.command} serve\` running`;
+export const nothingStored = (messenger) => `nothing stored for this chat yet — keep \`${typedCommand(messenger.app.command, "serve")}\` running`;
 /** Where a store-mode messenger's history comes from, for what it cannot do. */
 export const PUSHED = "this messenger's history is read from the local store";
 export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context` and `contacts list|show`";

package/dist/services/embeddings-maintenance.js

@@ -6,6 +6,7 @@ import { DEFAULT_TEXT_MODEL, textModel, vectorModelKey } from "../embeddings/mod
 import { remoteKey } from "../embeddings/remote.js";
 import { CONTEXT_MESSAGES, CONTEXT_MINUTES } from "../images/context/index.js";
 import { registeredImageProviders } from "../images/registry.js";
+import { typedCommand } from "../runs/scope.js";
 import { conversationsService } from "./conversations.js";
 import { storedChatId } from "./message-resolution.js";
 /** How much one run without `--chat` does at most, by default. */
@@ -16,11 +17,11 @@ const PER_SESSION = 8;
 const PER_REQUEST = 256;
 /** e5's tokenizer reads ~3.7 characters a token in Russian; 3 keeps the bound above the real count. */
 const CHARS_PER_TOKEN_AT_LEAST = 3;
-const notDownloaded = (deps, id) => new CliError("not_found", `${id} is not downloaded — \`${deps.messenger.app.command} models text download ${id}\``, {
+const notDownloaded = (deps, id) => new CliError("not_found", `${id} is not downloaded — \`${typedCommand(deps.messenger.app.command, `models text download ${id}`)}\``, {
     reason: "model.not-downloaded",
     model: id,
 });
-export const notBuiltError = (deps, chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${deps.messenger.app.command} conversations build --chat ${chatId}\``);
+export const notBuiltError = (deps, chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${typedCommand(deps.messenger.app.command, `conversations build --chat ${chatId}`)}\``);
 export const embeddingTarget = (deps, choice = DEFAULT_TEXT_MODEL) => {
     if (typeof choice !== "string") {
         const { remote, apiKey, concurrency = 4 } = choice;

package/dist/services/index.d.ts

@@ -156,7 +156,7 @@ export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, type ProposalTaskStore, proposalSource } from "./proposal-tasks.js";
 export type { RetentionQuery, RetentionService } from "./retention.js";
 export { retentionService } from "./retention.js";
-export { RESOURCES_SEARCHED, type SearchAllFound, type SearchAllItem, type SearchAllRequest, type SearchedResource, searchAll, } from "./search-all.js";
+export { RESOURCES_SEARCHED, type SearchAllFound, type SearchAllItem, type SearchAllMessenger, type SearchAllRequest, type SearchedResource, searchAll, } from "./search-all.js";
 export { type MeetingSearchCoverage, type MeetingSearchCursor, type MeetingSearchItem, RESOURCES_SEARCHED_WITH_MEETINGS, type ResourceWithMeetings, type SearchAllIncludingMeetingsFound, type SearchAllIncludingMeetingsRequest, type SearchAllWithMeetingsRequest, searchAllIncludingMeetings, searchAllWithMeetings, } from "./search-all-meetings.js";
 export { CATCH_UP_BOUNDS, type CatchUpOptions, type CatchUpResult, catchUpSearch, validateCatchUp, } from "./search-catchup.js";
 export { accountsOfKind, listContextOf, type SearchKind } from "./search-kind.js";

package/dist/services/search-all-meetings.d.ts

@@ -1,8 +1,7 @@
 import type { SearchHit } from "../meetings/index.js";
-import type { MessengerTraits } from "../ports/traits.js";
 import type { AccountKey, MessageStore } from "../store/store.js";
 import type { SearchFound, SearchQuery } from "./messages.js";
-import { type SearchAllFound, type SearchAllItem, type SearchAllRequest, type Skipped } from "./search-all.js";
+import { type SearchAllFound, type SearchAllItem, type SearchAllMessenger, type SearchAllRequest, type Skipped } from "./search-all.js";
 export declare const RESOURCES_SEARCHED_WITH_MEETINGS: readonly ["messages", "mail", "notes", "meetings"];
 export type ResourceWithMeetings = (typeof RESOURCES_SEARCHED_WITH_MEETINGS)[number];
 export interface MeetingSearchItem {
@@ -55,7 +54,7 @@ export interface SearchAllIncludingMeetingsFound extends Omit<SearchAllFound, "i
     meetings?: MeetingSearchCoverage;
 }
 /** Opt-in fusion of the existing unified ranking and one explicitly scoped meeting archive. */
-export declare const searchAllIncludingMeetings: (store: MessageStore, account: AccountKey, request: SearchAllIncludingMeetingsRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
+export declare const searchAllIncludingMeetings: (store: MessageStore, account: AccountKey, request: SearchAllIncludingMeetingsRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
 export interface SearchAllWithMeetingsRequest extends Omit<SearchAllIncludingMeetingsRequest, "meetingAccount"> {
     /**
      * `--source`: each kind reads the accounts the list names of it and a kind it names none of is skipped.
@@ -66,4 +65,4 @@ export interface SearchAllWithMeetingsRequest extends Omit<SearchAllIncludingMee
 /** Meetings have no index to search every account at once, so they are read only when named. */
 export declare const MEETINGS_UNNAMED = "meetings are searched only when --source names a meeting account, zoom or meetings";
 /** `search all`: every kind but meetings, unless `--source` names a meeting account. */
-export declare const searchAllWithMeetings: (store: MessageStore, account: AccountKey, request: SearchAllWithMeetingsRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
+export declare const searchAllWithMeetings: (store: MessageStore, account: AccountKey, request: SearchAllWithMeetingsRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;

package/dist/services/search-all.d.ts

@@ -81,9 +81,16 @@ export interface SearchAllRequest {
     /** The accounts `--source` chose, per kind; a kind left out reads every account of its own. */
     scope?: Partial<Record<SearchedResource, AccountKey[]>>;
 }
+export type SearchAllMessenger = Partial<Pick<MessengerTraits, "savedChatId" | "app">> & {
+    /**
+     * The tool named in a model-download hint, when it is not `app.command`: memo passes tg's identity for `group:`
+     * lists but has no `models` command. `null` names the tools that have one.
+     */
+    hintCommand?: string | null;
+};
 /**
  * `search all`: messages, mail and notes from the local store — messages also from the messenger's
  * server, as `search messages` asks it — each list best first, merged by reciprocal rank so no
  * resource's own scores have to be compared with another's.
  */
-export declare const searchAll: (store: MessageStore, account: AccountKey, request: SearchAllRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllFound>;
+export declare const searchAll: (store: MessageStore, account: AccountKey, request: SearchAllRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllFound>;

package/dist/services/search-all.js

@@ -21,7 +21,7 @@ export const searchAll = async (store, account, request, messenger = {}, searchM
     // Each resource is read deep enough for the merged page, then the merge is cut.
     const window = offset + request.limit;
     const only = request.only ?? RESOURCES_SEARCHED;
-    const command = messenger.app?.command;
+    const command = messenger.hintCommand === undefined ? messenger.app?.command : (messenger.hintCommand ?? undefined);
     const lists = [];
     const searched = [];
     const accounts = [];

package/dist/speech/transcribe.js

@@ -1,6 +1,7 @@
 import { CliError, isCliError } from "@wirecat/cli-base";
 import { fromFile } from "../cli/settings.js";
 import { capability } from "../ports/messenger.js";
+import { typedCommand } from "../runs/scope.js";
 import { installedBytes, isInstalled, megabytes, modelPath, modelsDirectory, vadPath } from "./install.js";
 import { orderedModels, speechModel } from "./models.js";
 /** `messenger`: its own recognition (Telegram Premium). `local`: a model on this machine. `auto`: the first, then the second. */
@@ -20,7 +21,7 @@ export const choose = (messenger, settings, flags, env = process.env) => {
 };
 /** Never a download: a model is hundreds of MB, and whether to fetch one is the owner's call. */
 export const notDownloaded = (messenger, model) => new CliError("not_found", `the speech model ${model.id} is not on this machine — the owner downloads it once with ` +
-    `\`${messenger.app.command} models audio download ${model.id}\` (${megabytes(installedBytes(model))})`, { reason: "model.not-downloaded", model: model.id });
+    `\`${typedCommand(messenger.app.command, `models audio download ${model.id}`)}\` (${megabytes(installedBytes(model))})`, { reason: "model.not-downloaded", model: model.id });
 /**
  * Over an open connection: the messenger's own transcript, or the recording's bytes for a local model.
  * The model runs after the connection closes — a minute of speech should not hold a socket open.

package/dist/store/chats.d.ts

@@ -1,5 +1,5 @@
 import type { ChannelTagMatch } from "../domain/channel-tags.js";
-import type { Chat, ChatKind, Id, Page } from "../domain/models.js";
+import type { Chat, ChatKind, ChatUpdate, Id, Page } from "../domain/models.js";
 import { type ChatRekey } from "./sqlite/chat-rekey.js";
 import type { ChatMetadata } from "./sqlite/chats.js";
 import type { ChatCompleteness } from "./sqlite/completeness.js";
@@ -7,7 +7,7 @@ import type { StoreContext } from "./sqlite/open.js";
 import type { Where } from "./sqlite/query-filter.js";
 import type { AccountKey, ChatActivity, ChatStats, StoredChatFilter } from "./types.js";
 export interface ChatsStore {
-    saveChats(key: AccountKey, chats: Chat[]): Promise<void>;
+    saveChats(key: AccountKey, chats: ChatUpdate[]): Promise<void>;
     /** Newest first. `query` matches three letters or more of a title; `unread` keeps chats with unread messages. */
     chats(key: AccountKey, window: {
         limit?: number;

package/dist/store/sqlite/chats.d.ts

@@ -1,5 +1,5 @@
 import type { ChannelTagMatch } from "../../domain/channel-tags.js";
-import type { Chat, Id, Member, Page } from "../../domain/models.js";
+import type { Chat, ChatUpdate, Id, Member, Page } from "../../domain/models.js";
 import type { AccountKey, StoredChatFilter } from "../types.js";
 import type { StoreContext } from "./open.js";
 /** The chat's own id, when the store key is a chat of this account. */
@@ -7,7 +7,7 @@ export declare const chatOf: ({ orm }: StoreContext, accountKey: number, chatKey
 export declare const findChatPk: ({ orm }: StoreContext, accountKey: number, chatId: Id) => number | undefined;
 /** A chat known only from its messages, until the chat list names it. */
 export declare const chatPkFor: (context: StoreContext, accountKey: number, chatId: Id) => number;
-export declare const upsertChat: (context: StoreContext, accountKey: number, chat: Chat) => void;
+export declare const upsertChat: (context: StoreContext, accountKey: number, chat: ChatUpdate) => void;
 /** Replaces who is in the chat, whole. */
 export declare const writeMembers: (context: StoreContext, key: AccountKey, accountKey: number, chatId: Id, memberIds: Id[]) => void;
 export declare const members: ({ orm }: StoreContext, chatKey: number) => Member[];

package/dist/store/sqlite/chats.js

@@ -45,10 +45,10 @@ export const upsertChat = (context, accountKey, chat) => {
         kind: chat.kind,
         parentChatId: parent,
         scope: chat.scope ?? null,
-        title: chat.title,
-        unreadCount: chat.unreadCount,
+        title: chat.title ?? null,
+        unreadCount: chat.unreadCount ?? null,
         lastMessageAt: toMs(chat.lastMessageAt),
-        participantsCount: chat.participantsCount,
+        participantsCount: chat.participantsCount ?? null,
         metadata: mergedMetadata(stored?.metadata ?? null, chat.providerMetadata),
         membershipState: chat.membershipState ?? null,
         createdAt: now(),
@@ -60,10 +60,10 @@ export const upsertChat = (context, accountKey, chat) => {
             kind: sql `excluded.kind`,
             ...(chat.parentChatId === undefined ? {} : { parentChatId: sql `excluded.parent_chat_id` }),
             scope: sql `coalesce(excluded.scope, ${chats.scope})`,
-            title: sql `excluded.title`,
-            unreadCount: sql `excluded.unread_count`,
-            lastMessageAt: sql `excluded.last_message_at`,
-            participantsCount: sql `excluded.participants_count`,
+            ...(chat.title === undefined ? {} : { title: sql `excluded.title` }),
+            ...(chat.unreadCount === undefined ? {} : { unreadCount: sql `excluded.unread_count` }),
+            ...(chat.lastMessageAt === undefined ? {} : { lastMessageAt: sql `excluded.last_message_at` }),
+            ...(chat.participantsCount === undefined ? {} : { participantsCount: sql `excluded.participants_count` }),
             metadata: sql `excluded.metadata`,
             // A chat the list names again has been rejoined; any other state it had is kept.
             membershipState: sql `CASE WHEN excluded.membership_state IS NOT NULL THEN excluded.membership_state

package/dist/store/types.d.ts

@@ -1,6 +1,6 @@
 import type { TextRange } from "../conversations/chunks.js";
 import type { Link } from "../conversations/link.js";
-import type { Chat, ChatKind, Id, MessageHit, Provider } from "../domain/models.js";
+import type { Chat, ChatKind, ChatUpdate, Id, MessageHit, Provider } from "../domain/models.js";
 import type * as imageChunks from "./sqlite/image-chunks.js";
 import type { Where } from "./sqlite/query-filter.js";
 export type PictureInput = imageChunks.PictureInput;
@@ -82,7 +82,7 @@ export type MessageFilter = AccountMessageFilter & {
     chatId?: undefined;
 });
 export interface Delta {
-    chats?: Chat[];
+    chats?: ChatUpdate[];
     people?: PersonFacts[];
     members?: Map<Id, Id[]>;
     state?: Record<string, string>;

package/dist/terminal/login-qr.d.ts

@@ -0,0 +1,27 @@
+import { CliError } from "@wirecat/cli-base";
+/** Whether a person can scan a code drawn here and answer what the login asks next. */
+export declare const atTerminal: (input: NodeJS.ReadableStream & {
+    isTTY?: boolean;
+}) => boolean;
+/** The one refusal of a QR login that nobody could scan. */
+export declare const qrNeedsTerminal: (command: string) => CliError;
+export interface LoginQrOptions {
+    /** `--qr-file`: the PNG to write instead of drawing the code. */
+    qrFile?: string;
+    /** Where the code and the narrow-terminal hint go; `--quiet` must not hide either. */
+    diagnostic: (text: string) => void;
+    /** Where the file's location is said. */
+    note: (text: string) => void;
+    /** How far the code sits right, to line up under a setup step. */
+    indent?: number;
+    /** Read on every code, so a widened terminal draws the next one. Unknown draws the code. */
+    columns?: () => number | undefined;
+}
+export interface LoginQr {
+    readonly path: string | undefined;
+    /** Never throws for a code that does not fit: the messengers call it from inside their own event loops. */
+    show: (link: string) => void;
+    /** The image logs the account in while it is valid; call this in `finally`. */
+    close: () => void;
+}
+export declare const loginQr: ({ qrFile, diagnostic, note, indent: pad, columns, }: LoginQrOptions) => LoginQr;

package/dist/terminal/login-qr.js

@@ -0,0 +1,44 @@
+import { rmSync } from "node:fs";
+import { resolve } from "node:path";
+import { CliError, indent, writeSecurely } from "@wirecat/cli-base";
+import { inputPolicy } from "../cli/input-policy.js";
+import { qrPng, terminalQr } from "./qr.js";
+const MARGIN = 2;
+/** Whether a person can scan a code drawn here and answer what the login asks next. */
+export const atTerminal = (input) => input.isTTY === true && !inputPolicy(input).noInput;
+/** The one refusal of a QR login that nobody could scan. */
+export const qrNeedsTerminal = (command) => new CliError("validation_error", `${command} shows a QR code to scan — run it in a terminal, or pass --qr-file <png>`, {
+    param: "--qr-file",
+    reason: "input.required",
+});
+export const loginQr = ({ qrFile, diagnostic, note, indent: pad = 0, columns = () => process.stderr.columns, }) => {
+    const path = qrFile === undefined ? undefined : resolve(qrFile);
+    // Only what this login wrote is removed: a refused or never-reached write leaves the owner's file alone.
+    let written = false;
+    return {
+        path,
+        show: (link) => {
+            if (path) {
+                writeSecurely(path, qrPng(link), 0o600);
+                written = true;
+                note(`the QR code is in ${path} — it is replaced when the code renews`);
+                return;
+            }
+            const drawn = terminalQr(link);
+            const need = drawn.width + pad + MARGIN;
+            const width = columns();
+            if (width !== undefined && need > width) {
+                diagnostic(`the terminal is ${width} columns wide and the QR code needs ${need} — widen it, ` +
+                    "or run again with --qr-file <png>");
+                return;
+            }
+            diagnostic(`\n${indent(drawn.text, pad + MARGIN)}`);
+        },
+        close: () => {
+            if (!path || !written)
+                return;
+            written = false;
+            rmSync(path, { force: true });
+        },
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.346.0",
+  "version": "0.348.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -202,7 +202,7 @@
     "@types/node": "^22.20.4",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.2",
-    "@wirecat/cli-base": "0.46.0",
+    "@wirecat/cli-base": "0.47.0",
     "commander": "15.0.0",
     "cspell": "10.3.6",
     "drizzle-kit": "1.0.0-rc.4",
@@ -222,7 +222,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.45.0 <0.47.0",
+    "@wirecat/cli-base": ">=0.47.0 <0.48.0",
     "commander": ">=15"
   },
   "bin": {

package/parity.json

@@ -2847,6 +2847,14 @@
         "wa": "wa backlog: mount the shared flood command"
       }
     },
+    "guide": {
+      "in": [],
+      "planned": {
+        "max": "help-navigation pass: max-cli#737 mounts guide with scenarios",
+        "tg": "help-navigation pass: mount guide with scenarios",
+        "wa": "help-navigation pass: mount guide with scenarios"
+      }
+    },
     "images": {
       "in": "all"
     },
@@ -4047,7 +4055,9 @@
         },
         "--qr-file": {
           "in": ["tg", "wa"],
-          "reason": "ruled tg-only with the app registration it belongs to"
+          "planned": {
+            "max": "max-cli#736, on the cli-core release that exports loginQr"
+          }
         },
         "--sms": {
           "in": ["tg"],
@@ -4066,7 +4076,9 @@
         "--method": "all",
         "--qr-file": {
           "in": ["tg", "wa"],
-          "reason": "Telegram can expose its temporary QR login token as a PNG"
+          "planned": {
+            "max": "max-cli#736, on the cli-core release that exports loginQr"
+          }
         }
       }
     },