refactor: normalize cli command hints

src/cli/command-format.ts

@@ -0,0 +1,16 @@
+import { normalizeProfileName } from "./profile-utils.js";
+
+const CLI_PREFIX_RE = /^(?:pnpm|npm|bunx|npx)\s+clawdbot\b|^clawdbot\b/;
+const PROFILE_FLAG_RE = /\b--profile\b/;
+const DEV_FLAG_RE = /\b--dev\b/;
+
+export function formatCliCommand(
+  command: string,
+  env: Record<string, string | undefined> = process.env as Record<string, string | undefined>,
+): string {
+  const profile = normalizeProfileName(env.CLAWDBOT_PROFILE);
+  if (!profile) return command;
+  if (!CLI_PREFIX_RE.test(command)) return command;
+  if (PROFILE_FLAG_RE.test(command) || DEV_FLAG_RE.test(command)) return command;
+  return command.replace(CLI_PREFIX_RE, (match) => `${match} --profile ${profile}`);
+}