feat(brand): rebrand user-facing surfaces to Coven + direct-invocation notice (Phase 5) (#154)

* feat(brand): rebrand user-facing surfaces to Coven; add direct-invocation engine notice

Renames the ~17 user-facing "Coven Code" strings (system prompt identity, TUI
welcome/title/dialogs, User-Agent, help text, npm description) to the unified
"Coven" brand. Adds a dim one-line notice when coven-code is run directly in an
interactive TTY without COVEN_PARENT, pointing users at the unified `coven` CLI.
Binary name, crate names, env vars, and internal paths are unchanged.

* feat(brand): complete user-facing Coven Code -> Coven sweep (commands, tips, dialogs, oauth, acp)

* docs: add Phase 5 brand-sweep plan

* test(tui): track renamed boot banner 'Coven v' in interactive suite

Author: BunsDev

docs/superpowers/plans/2026-07-14-phase5-brand-sweep.md

@@ -0,0 +1,41 @@
+# Phase 5 — Brand / UX Naming Sweep
+
+> Phase 5 sub-plan of the coven CLI unification. Curated, recon-grounded. Only USER-FACING surfaces change; the binary name (`coven-code`/`coven-cave`), `claurst-*` crates, `COVEN_CODE_*` env vars, `.coven-code` internal paths, and repo URLs STAY (per COVEN.md).
+
+**Goal:** users see the unified "Coven" brand; nobody is told to install/use "coven-code" separately; `coven --version` surfaces the whole stack.
+
+## Decisions (defaults — vetoable in review)
+- npm package NAME stays `@opencoven/coven-code` (only description changes; it is DEPRECATED in 5.6, not renamed — renaming a published package is disruptive and breaks the engine install/release flow).
+- Assistant identity → "You are Coven, an open-source agentic coding assistant by OpenCoven (based on Claurst, GPL-3.0)." (keep the credit).
+- User-Agent `CovenCode/x.y` → `Coven/x.y`.
+- Direct-invocation notice (dim, stderr): `coven-code is the Coven engine — the supported CLI is 'coven' (npm i -g @opencoven/cli)`.
+
+## Already done (verified — no-op tasks)
+- **Theme (5.4):** `crates/tui/src/theme_colors.rs default_theme()` is ALREADY the OpenCoven palette (accent `Rgb(139,92,246)` #8B5CF6, secondary `Rgb(236,72,153)` #EC4899). Nothing to change.
+- **Completions (5.5):** `coven completions` generates from the clap `Command`, so the passthroughs (auth/models/acp/code) are already covered. Add a coven-side test asserting they appear (optional).
+
+## Task 5.1 + 5.2 — coven-code brand sweep [coven-code]
+### 5.2 — rename the ~17 user-facing strings (curated list; do NOT touch anything else)
+- `crates/core/src/system_prompt.rs:174,177` — "You are Coven Code, ..." → "You are Coven, ..." (keep the "(based on Claurst.../GPL-3.0)" credit).
+- `crates/cli/src/main.rs:123` — `about = "Coven Code - AI-powered coding assistant"` → `"Coven - AI-powered coding assistant"`. `:4689` — auth help "...Coven Code OAuth client" → "...Coven OAuth client".
+- `crates/tools/src/web_search.rs:163` — `"CovenCode/1.0"` → `"Coven/1.0"`.
+- `crates/core/src/update_check.rs:67` — `format!("CovenCode/{}", current)` → `format!("Coven/{}", current)`.
+- `crates/tui/src/onboarding_dialog.rs:304,320,333,337` — "Welcome to Coven Code" / "Coven Code is..." / "Coven Code can..." → "Coven".
+- `crates/tui/src/lib.rs:345,371` — terminal title `"✨ Coven Code"` → `"✨ Coven"`.
+- `crates/tui/src/invalid_config_dialog.rs:159,164,168` — "Restart Coven Code." → "Restart Coven.".
+- `crates/tui/src/export_dialog.rs:171,176` — "# Coven Code Conversation Export" → "# Coven Conversation Export"; the `"**Coven Code**"` assistant role label → "**Coven**".
+- `crates/tui/src/feedback_survey.rs:146` — "How is Coven Code doing this session?" → "How is Coven doing this session?".
+- `npm/package.json:4` — description: replace "Coven engine (agentic coding TUI)..." wording's "Coven Code" (if present) — keep pointing at @opencoven/cli. NAME unchanged.
+DO NOT change: binary/crate/env/path/theme-const/test/comment/repo-URL references.
+
+### 5.1 — direct-invocation notice [coven-code]
+In `crates/cli/src/main.rs` after `Cli::parse()` (~line 503) and after the `is_headless` determination (~643): if the run is INTERACTIVE (not headless/print/prompt), stdout/stderr is a TTY (`crossterm::terminal::is_terminal`), AND `COVEN_PARENT` is unset → `eprintln!` the dim notice once (before `run_interactive`). Silent when `COVEN_PARENT` is set (driven by coven) or non-interactive. The `coven-cave` alias re-execs `coven-code`, so it inherits this. Test the pure decision (`should_show_engine_notice(is_interactive, is_tty, coven_parent_set) -> bool`).
+
+## Task 5.3 — `coven --version` surfaces engine + pin [coven] — IN PROGRESS
+Custom `--version` intercept → `coven <desc> (engine coven-code <installed|not installed>, pinned <pinned>)`. (dispatched)
+
+## Task 5.6 — npm deprecation [HELD — outward-facing, needs explicit user go-ahead]
+`npm deprecate @opencoven/coven-code "Install @opencoven/cli — coven-code is now the Coven engine"`. Engine binaries keep shipping via GitHub Releases. DO NOT run autonomously; surface for confirmation.
+
+## Exit check
+A new user reaches install → first session without seeing the string "coven-code" in any prose surface; running `coven-code` directly prints the "use coven" hint; `coven --version` shows coven + engine + pin.

scripts/tui-tests/cases/02_startup.sh

@@ -15,7 +15,7 @@ tc_startup() {
   wait_for "What's new" 5
   local s; s="$(tui_capture)"
 
-  assert_contains "$s" "Coven Code v" "title banner renders with version"
+  assert_contains "$s" "Coven v" "title banner renders with version"
 
   # Right-hand welcome column. Wording is stable; the username is not, so we
   # assert on the static labels only.

scripts/tui-tests/cases/06_quit.sh

@@ -16,7 +16,7 @@ tc_quit() {
 
   # Prove the process actually exited by dropping a marker on the shell that
   # is revealed once the TUI tears down.
-  if wait_for "Coven Code v" 2; then
+  if wait_for "Coven v" 2; then
     : # still showing — fall through to explicit check below
   fi
   tui_type "echo __TUI_EXITED__"; tui_keys Enter

scripts/tui-tests/lib.sh

@@ -20,7 +20,7 @@ set -uo pipefail
 : "${TUI_SOCKET:=coven-tui-test}"        # dedicated tmux server socket (-L)
 : "${TUI_WIDTH:=120}"                    # terminal columns
 : "${TUI_HEIGHT:=40}"                    # terminal rows
-: "${TUI_BOOT_STRING:=Coven Code v}"     # string proving the TUI has drawn
+: "${TUI_BOOT_STRING:=Coven v}"          # string proving the TUI has drawn
 : "${TUI_WAIT_TIMEOUT:=20}"              # seconds to wait for a string
 : "${TUI_POLL_INTERVAL:=0.4}"            # seconds between capture polls
 : "${TUI_SETTLE:=0.6}"                   # seconds to let a keypress redraw

src-rust/crates/acp/src/server.rs

@@ -136,7 +136,7 @@ impl AgentServer {
         *self.client_capabilities.write() = req.client_capabilities.clone();
 
         let agent_info = acp::Implementation::new("coven-code", env!("CARGO_PKG_VERSION"))
-            .title(Some("Coven Code".to_string()));
+            .title(Some("Coven".to_string()));
 
         let mut response = acp::InitializeResponse::new(acp::ProtocolVersion::V1)
             .agent_capabilities(

src-rust/crates/cli/src/codex_oauth_flow.rs

@@ -166,7 +166,7 @@ async fn wait_for_callback(listener: TcpListener) -> anyhow::Result<(String, Str
     // Send HTML response to browser before processing
     let html = if error.is_empty() {
         "<html><body style='background:#131010;color:#f1ecec;display:flex;justify-content:center;align-items:center;height:100vh;font-family:system-ui'>\
-         <div style='text-align:center'><h1>Authorization Successful</h1><p>You can close this window and return to Coven Code.</p></div>\
+         <div style='text-align:center'><h1>Authorization Successful</h1><p>You can close this window and return to Coven.</p></div>\
          <script>setTimeout(()=>window.close(),2000)</script></body></html>"
     } else {
         "<html><body style='background:#131010;color:#f1ecec;display:flex;justify-content:center;align-items:center;height:100vh;font-family:system-ui'>\

src-rust/crates/cli/src/headless.rs

@@ -1544,7 +1544,7 @@ pub fn write_result(path: &Path, envelope: &ResultEnvelope) -> anyhow::Result<()
 fn familiar_name(brief: Option<&SessionBrief>) -> String {
     brief
         .map(|b| b.familiar.display_name.clone())
-        .unwrap_or_else(|| "Coven Code".to_string())
+        .unwrap_or_else(|| "Coven".to_string())
 }
 
 /// One-line, familiar-voice summary (Check Run + PR title). Prefers the first

src-rust/crates/cli/src/main.rs

@@ -120,7 +120,7 @@ impl Tool for McpToolWrapper {
 #[command(
     name = "coven-code",
     version = APP_VERSION,
-    about = "Coven Code - AI-powered coding assistant",
+    about = "Coven - AI-powered coding assistant",
     long_about = None,
 )]
 struct Cli {
@@ -199,7 +199,7 @@ struct Cli {
     #[arg(long = "auto-commits", action = ArgAction::SetTrue)]
     auto_commits: bool,
 
-    /// Grant Coven Code access to an additional directory (can be repeated)
+    /// Grant Coven access to an additional directory (can be repeated)
     #[arg(long = "add-dir", value_name = "DIR", action = ArgAction::Append)]
     add_dir: Vec<PathBuf>,
 
@@ -998,6 +998,16 @@ async fn main() -> anyhow::Result<()> {
     }
 
     // Interactive REPL mode
+    if should_show_engine_notice(
+        !is_headless,
+        std::io::IsTerminal::is_terminal(&std::io::stderr()),
+        std::env::var_os("COVEN_PARENT").is_some(),
+    ) {
+        eprintln!(
+            "\x1b[2mcoven-code is the Coven engine \u{2014} the supported CLI is 'coven' (npm i -g @opencoven/cli)\x1b[0m"
+        );
+    }
+
     let auth_store = claurst_core::AuthStore::load();
     let has_saved_credentials = !auth_store.credentials.is_empty()
         || claurst_core::oauth_config::get_codex_tokens().is_some();
@@ -1356,10 +1366,7 @@ fn spawn_models_cache_refresh() {
         let url = models_source_url();
         let resp = match client
             .get(&url)
-            .header(
-                "User-Agent",
-                concat!("CovenCode/", env!("CARGO_PKG_VERSION")),
-            )
+            .header("User-Agent", concat!("Coven/", env!("CARGO_PKG_VERSION")))
             .send()
             .await
         {
@@ -4686,7 +4693,9 @@ async fn handle_auth_command(args: &[String]) -> anyhow::Result<()> {
 
 fn print_auth_usage() {
     eprintln!("Usage: coven-code auth <subcommand>");
-    eprintln!("  login [--console] [--label <name>]   Authenticate with a configured Coven Code OAuth client");
+    eprintln!(
+        "  login [--console] [--label <name>]   Authenticate with a configured Coven OAuth client"
+    );
     eprintln!("  logout                                Remove the active account's credentials");
     eprintln!("  status [--json]                       Show authentication status");
     eprintln!("  list                                  List all stored Anthropic accounts");
@@ -5028,7 +5037,7 @@ async fn auth_status(json_output: bool) {
         .or_else(|| {
             usable_oauth_tokens.map(|tokens| {
                 if tokens.uses_bearer_auth() {
-                    "Coven Code Account".to_string()
+                    "Coven Account".to_string()
                 } else {
                     "Console Account".to_string()
                 }
@@ -5208,6 +5217,12 @@ fn json_null_or_string(opt: &Option<String>) -> serde_json::Value {
     }
 }
 
+/// Show the "use coven" hint only for a direct interactive run that is NOT
+/// driven by the unified coven CLI.
+fn should_show_engine_notice(is_interactive: bool, is_tty: bool, coven_parent_set: bool) -> bool {
+    is_interactive && is_tty && !coven_parent_set
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
@@ -5579,4 +5594,30 @@ mod tests {
         assert!(cli.print);
         assert_eq!(cli.prompt.as_deref(), Some("hello"));
     }
+
+    // --- should_show_engine_notice truth table ---
+
+    #[test]
+    fn engine_notice_shown_for_direct_interactive_tty() {
+        // All three conditions met: interactive + TTY + no COVEN_PARENT
+        assert!(should_show_engine_notice(true, true, false));
+    }
+
+    #[test]
+    fn engine_notice_suppressed_when_coven_parent_set() {
+        // Driven by the unified coven CLI
+        assert!(!should_show_engine_notice(true, true, true));
+    }
+
+    #[test]
+    fn engine_notice_suppressed_when_non_interactive() {
+        // Headless/print/prompt mode
+        assert!(!should_show_engine_notice(false, true, false));
+    }
+
+    #[test]
+    fn engine_notice_suppressed_when_not_a_tty() {
+        // Piped stdout/stderr (e.g. CI, script)
+        assert!(!should_show_engine_notice(true, false, false));
+    }
 }

src-rust/crates/cli/src/oauth_flow.rs

@@ -184,7 +184,7 @@ fn configured_anthropic_oauth_client_id() -> anyhow::Result<String> {
         .filter(|value| !value.is_empty())
         .ok_or_else(|| {
             anyhow::anyhow!(
-                "Anthropic OAuth requires a Coven Code OAuth client ID. Set {} after registering a first-party OAuth client, or use ANTHROPIC_API_KEY for now.",
+                "Anthropic OAuth requires a Coven OAuth client ID. Set {} after registering a first-party OAuth client, or use ANTHROPIC_API_KEY for now.",
                 oauth::CLIENT_ID_ENV
             )
         })