docs(cli): keep chat-header animation rationale behavioral

Author: c8dhjp4tyv-bit

cli/src/utils/chat-header-animation.ts

@@ -1,6 +1,6 @@
 /**
- * Freebuff's chat logo sheen can make the focused input appear to flicker.
- * Keep the animation for Codebuff while leaving the Freebuff chat header static.
+ * Freebuff intentionally keeps the chat-header logo static.
+ * Keep the existing sheen for Codebuff while honoring the global animation gate.
  */
 export function shouldAnimateChatHeader(
   animationEnabled: boolean,