fix(cli): explain parser errors

src/cli/program/error-output.test.ts

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+import { formatCliParseErrorOutput } from "./error-output.js";
+
+describe("formatCliParseErrorOutput", () => {
+  it("explains unknown commands with root help and plugin hints", () => {
+    const output = formatCliParseErrorOutput("error: unknown command 'wat'\n", {
+      argv: ["node", "openclaw", "wat"],
+    });
+
+    expect(output).toContain('OpenClaw does not know the command "wat".');
+    expect(output).toContain("openclaw --help");
+    expect(output).toContain("openclaw plugins list");
+  });
+
+  it("points unknown options at the active command help", () => {
+    const output = formatCliParseErrorOutput("error: unknown option '--wat'\n", {
+      argv: ["node", "openclaw", "channels", "status", "--wat"],
+    });
+
+    expect(output).toContain('OpenClaw does not recognize option "--wat".');
+    expect(output).toContain("openclaw channels status --help");
+  });
+
+  it("points missing required arguments at command help", () => {
+    const output = formatCliParseErrorOutput("error: missing required argument 'name'\n", {
+      argv: ["node", "openclaw", "plugins", "install"],
+    });
+
+    expect(output).toContain('Missing required argument "name".');
+    expect(output).toContain("openclaw plugins install --help");
+  });
+});