@wirecat/cli-core 0.435.0 → 0.436.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
+## Unreleased
+
+## 0.436.0 — 26.10.2026
+
+### Fixed
+
+- **`--help-all` shows the profile with a command that takes one.** The example after "The first word is the profile
+  whenever it is not a command" skipped only cli-core's own profile-free commands, so a CLI whose first command was
+  marked `profileFree` (cli-template's `doctor`) printed `clidev personal doctor`. It now skips every command that
+  takes no profile, at every level: `clidev personal mcp`. A CLI where no command takes a profile no longer prints
+  the three profile sentences at all, instead of `personal <command>`. A messenger CLI's text is unchanged, so the
+  help snapshots in tg-cli, max-cli and whatsapp-cli change only if a CLI's first command is `profileFree`.
+
 ## 0.435.0 — 25.10.2026
 
 ### Added

package/dist/cli/profile.d.ts

@@ -35,5 +35,8 @@ export declare const valuedOptions: (program: Command) => Set<string>;
 export declare const refuseCommandName: (profile: string, words: Set<string>, command: string) => void;
 /** The root of the command tree, from anywhere inside it. */
 export declare const rootOf: (command: Command) => Command;
-/** A command this CLI really has, for an example: the first that takes a profile, down to its first leaf. */
+/**
+ * A command this CLI really has, for an example: the first path down to a leaf that takes a profile,
+ * skipping `PROFILE_FREE` and `profileFree` ones. Works on commands not yet added to the program.
+ */
 export declare const sampleCommand: (commands: readonly Command[]) => string | undefined;

package/dist/cli/profile.js

@@ -78,13 +78,28 @@ export const rootOf = (command) => {
         root = root.parent;
     return root;
 };
-/** A command this CLI really has, for an example: the first that takes a profile, down to its first leaf. */
+/**
+ * A command this CLI really has, for an example: the first path down to a leaf that takes a profile,
+ * skipping `PROFILE_FREE` and `profileFree` ones. Works on commands not yet added to the program.
+ */
 export const sampleCommand = (commands) => {
-    const words = [];
-    let command = commands.find((one) => !PROFILE_FREE.has(one.name()));
-    while (command) {
-        words.push(command.name());
-        command = command.commands.find((one) => one.name() !== "help");
+    const pathFrom = (command) => {
+        if (freeOfProfile.has(command))
+            return undefined;
+        const children = command.commands.filter((one) => one.name() !== "help");
+        if (children.length === 0)
+            return [command.name()];
+        for (const child of children) {
+            const rest = pathFrom(child);
+            if (rest)
+                return [command.name(), ...rest];
+        }
+        return undefined;
+    };
+    for (const command of commands) {
+        const path = PROFILE_FREE.has(command.name()) ? undefined : pathFrom(command);
+        if (path)
+            return path.join(" ");
     }
-    return words.length ? words.join(" ") : undefined;
+    return undefined;
 };

package/dist/cli/program.js

@@ -42,13 +42,17 @@ export const createProgram = ({ app, commands, configure, firstScreen }, { out,
     const messenger = app.messenger !== false;
     const found = messenger ? "found messages" : "found items";
     const content = messenger ? "message content" : "content";
+    const sample = messenger ? "chats list" : sampleCommand(mounted);
+    // A CLI where every command is profile-free has nothing to show a profile with, so it says nothing about one.
+    const profileHelp = sample
+        ? `\n\nThe first word is the profile whenever it is not a command — \`${app.command} personal ${sample}\`.\n` +
+            `\`${app.envPrefix}_PROFILE\` says the same thing for a whole shell session.\n` +
+            "No profile is assumed: without one, a command that uses an account stops and lists the profiles here."
+        : "";
     program
         .name(app.command)
         .usage("[profile] [options] <command>")
-        .description(`${app.description}\n\n` +
-        `The first word is the profile whenever it is not a command — \`${app.command} personal ${messenger ? "chats list" : (sampleCommand(mounted) ?? "<command>")}\`.\n` +
-        `\`${app.envPrefix}_PROFILE\` says the same thing for a whole shell session.\n` +
-        "No profile is assumed: without one, a command that uses an account stops and lists the profiles here.")
+        .description(`${app.description}${profileHelp}`)
         .version(app.version, "-V, --version")
         .option("-v, --verbose", "more detail in what is shown: -v ids, -vv everything we know", (_, level) => level + 1, 0)
         .option("--json", "machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.435.0",
+  "version": "0.436.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",