refactor: normalize cli command hints

src/cli/profile.test.ts

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { describe, expect, it } from "vitest";
+import { formatCliCommand } from "./command-format.js";
 import { applyCliProfileEnv, parseCliProfileArgs } from "./profile.js";
 
 describe("parseCliProfileArgs", () => {
@@ -76,3 +77,63 @@ describe("applyCliProfileEnv", () => {
     expect(env.CLAWDBOT_CONFIG_PATH).toBe(path.join("/custom", "clawdbot.json"));
   });
 });
+
+describe("formatCliCommand", () => {
+  it("returns command unchanged when no profile is set", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", {})).toBe("clawdbot doctor --fix");
+  });
+
+  it("returns command unchanged when profile is default", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", { CLAWDBOT_PROFILE: "default" })).toBe(
+      "clawdbot doctor --fix",
+    );
+  });
+
+  it("returns command unchanged when profile is Default (case-insensitive)", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", { CLAWDBOT_PROFILE: "Default" })).toBe(
+      "clawdbot doctor --fix",
+    );
+  });
+
+  it("returns command unchanged when profile is invalid", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", { CLAWDBOT_PROFILE: "bad profile" })).toBe(
+      "clawdbot doctor --fix",
+    );
+  });
+
+  it("returns command unchanged when --profile is already present", () => {
+    expect(
+      formatCliCommand("clawdbot --profile work doctor --fix", { CLAWDBOT_PROFILE: "work" }),
+    ).toBe("clawdbot --profile work doctor --fix");
+  });
+
+  it("returns command unchanged when --dev is already present", () => {
+    expect(formatCliCommand("clawdbot --dev doctor", { CLAWDBOT_PROFILE: "dev" })).toBe(
+      "clawdbot --dev doctor",
+    );
+  });
+
+  it("inserts --profile flag when profile is set", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", { CLAWDBOT_PROFILE: "work" })).toBe(
+      "clawdbot --profile work doctor --fix",
+    );
+  });
+
+  it("trims whitespace from profile", () => {
+    expect(formatCliCommand("clawdbot doctor --fix", { CLAWDBOT_PROFILE: "  jbclawd  " })).toBe(
+      "clawdbot --profile jbclawd doctor --fix",
+    );
+  });
+
+  it("handles command with no args after clawdbot", () => {
+    expect(formatCliCommand("clawdbot", { CLAWDBOT_PROFILE: "test" })).toBe(
+      "clawdbot --profile test",
+    );
+  });
+
+  it("handles pnpm wrapper", () => {
+    expect(formatCliCommand("pnpm clawdbot doctor", { CLAWDBOT_PROFILE: "work" })).toBe(
+      "pnpm clawdbot --profile work doctor",
+    );
+  });
+});