refactor: drop hidden bub message CLI alias (#144)

Author: PsiACE

docs/architecture.md

@@ -49,7 +49,7 @@ Builtin `BuiltinImpl` behavior includes:
 - `build_prompt`: supports comma command mode; non-command text may include `context_str`.
 - `run_model`: delegates to `Agent.run()`.
 - `system_prompt`: combines a default prompt with workspace `AGENTS.md`.
-- `register_cli_commands`: installs `run`, `gateway`, `chat`, plus hidden compatibility/diagnostic commands.
+- `register_cli_commands`: installs `run`, `gateway`, `chat`, plus hidden diagnostic commands.
 - `provide_channels`: returns `telegram` and `cli` channel adapters.
 - `provide_tape_store`: returns a file-backed tape store under `~/.bub/tapes`.
 

docs/channels/cli.md

@@ -1,6 +1,6 @@
 # CLI
 
-`bub` exposes four main commands (`run`, `gateway`, `chat`, `login`) plus two hidden ones (`hooks` for diagnostics, `message` as a compatibility alias for `gateway`).
+`bub` exposes four main commands (`run`, `gateway`, `chat`, `login`) plus one hidden one (`hooks` for diagnostics).
 
 ## `bub run`
 
@@ -56,8 +56,6 @@ Enable only selected channels:
 uv run bub gateway --enable-channel telegram
 ```
 
-`bub message` is kept as a hidden compatibility alias and forwards to the same command implementation.
-
 ## `bub chat`
 
 Start an interactive REPL session via the `cli` channel.

src/bub/builtin/hook_impl.py

@@ -117,7 +117,7 @@ def register_cli_commands(self, app: typer.Typer) -> None:
         app.command("chat")(cli.chat)
         app.add_typer(cli.login_app)
         app.command("hooks", hidden=True)(cli.list_hooks)
-        app.command("message", hidden=True)(app.command("gateway")(cli.gateway))
+        app.command("gateway")(cli.gateway)
 
     def _read_agents_file(self, state: State) -> str:
         workspace = state.get("_runtime_workspace", str(Path.cwd()))

tests/test_framework.py

@@ -94,19 +94,19 @@ def system_prompt(self, prompt: str, state: dict[str, str]) -> str | None:
     assert prompt == "low\n\nhigh"
 
 
-def test_builtin_cli_exposes_login_and_keeps_message_hidden_alias() -> None:
+def test_builtin_cli_exposes_login_and_gateway_command() -> None:
     framework = BubFramework()
     framework.load_hooks()
     app = framework.create_cli_app()
     runner = CliRunner()
 
     help_result = runner.invoke(app, ["--help"])
-    alias_result = runner.invoke(app, ["message", "--help"])
+    gateway_result = runner.invoke(app, ["gateway", "--help"])
 
     assert help_result.exit_code == 0
     assert "login" in help_result.stdout
     assert "gateway" in help_result.stdout
     assert "│ message" not in help_result.stdout
-    assert alias_result.exit_code == 0
-    assert "bub message" in alias_result.stdout
-    assert "Start message listeners" in alias_result.stdout
+    assert gateway_result.exit_code == 0
+    assert "bub gateway" in gateway_result.stdout
+    assert "Start message listeners" in gateway_result.stdout