@bli-cockpit/cli 0.2.78 → 0.2.80

package/dist/commands/local-help.js

@@ -100,10 +100,21 @@ export function localCommandHelp(command) {
         `Default dashboard: ${DEFAULT_DASHBOARD_URL}. Omit --dashboard-url for normal production use; pass it only for staging/custom dashboards or to force a different pairing.`,
     ].join("\n");
 }
-/** `cockpit <command> --help` — the command name alone, with only the help flag. */
+/**
+ * `cockpit <command> --help`, and since BLI-3833 `cockpit <command> <verb>
+ * --help` too — QA tick 21 found `cockpit cal create --help` printing the whole
+ * usage wall to stderr and exiting 1 on all eight nouns, because the gate only
+ * accepted the command name alone. The verb is not validated here: a verb the
+ * manual does not know still gets the command's own manual, which names every
+ * verb it has, at exit 0.
+ */
 export function isLocalHelpRequest(argv) {
     const command = argv[0];
     if (!command || !rootCommandNames.has(command))
         return false;
-    return argv.length === 2 && (argv[1] === "--help" || argv[1] === "-h");
+    const last = argv[argv.length - 1];
+    const helpFlag = last === "--help" || last === "-h";
+    if (argv.length === 2)
+        return helpFlag;
+    return argv.length === 3 && helpFlag && !String(argv[1]).startsWith("-");
 }

package/dist/commands/local.js

@@ -1,5 +1,5 @@
 import { defaultIo, errorMessage, writeLine } from "./cli-io.js";
-import { isLocalHelpRequest, localCommandHelp } from "./local-help.js";
+import { isLocalHelpRequest, localCommandHelp, rootCommandNames } from "./local-help.js";
 import { describeError } from "../health-detail.js";
 import { reportInstallEventsBestEffort } from "./install-receipts.js";
 import { persistOnboardingRootConfig, resolveOnboardingRootsForCommand, } from "./collection-roots.js";
@@ -60,7 +60,14 @@ export async function runLocalCockpitCli(argv, io = defaultIo()) {
     catch (error) {
         writeLine(io.stderr, errorMessage(error));
         writeLine(io.stderr, "");
-        writeLine(io.stderr, localCommandHelp());
+        // A refused `cockpit cal create --meet` used to print its one correct
+        // reason line and then the WHOLE collector wall — onboard, update, forty
+        // more — so the reason drowned and Edward read it as "it just shows usage"
+        // (2026-09-06). A parse error on a KNOWN command gets that command's own
+        // manual, which names the flags the reason line just asked for; only an
+        // unknown command earns the wall.
+        const command = argv[0];
+        writeLine(io.stderr, command && rootCommandNames.has(command) ? localCommandHelp(command) : localCommandHelp());
         return 1;
     }
     // A limit typed on the command line is remembered for every later run,

package/dist/commands/public-root.js

@@ -15,7 +15,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.78");
+    writeLine(io?.stdout ?? process.stdout, "0.2.80");
     return 0;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.78",
+  "version": "0.2.80",
   "private": false,
   "type": "module",
   "bin": {
@@ -27,7 +27,7 @@
     "test": "node dist/cli.js --help && node ../../scripts/assert-public-cli-routing.mjs && node ../../scripts/assert-public-cli-verb-help.mjs && node ../../scripts/assert-public-cli-runtime-files.mjs && node ../../scripts/assert-public-cli-no-fleet-posts.mjs && node ../../scripts/assert-public-package-pack.mjs --workspace=@bli-cockpit/cli"
   },
   "dependencies": {
-    "@bli-cockpit/memory-mcp": "0.1.11",
+    "@bli-cockpit/memory-mcp": "0.1.12",
     "@bli-cockpit/mcp": "0.1.15",
     "@bli-cockpit/telemetry-core": "0.1.32"
   }