"""Command-level tests: init flow, destructive confirms, JSON output contract, exit codes. Uses Typer's CliRunner against the real `app`. stdout is not a TTY under CliRunner, so `use_json()` returns True and the CLI emits JSON — which is exactly what scripts and agents consume. """ from __future__ import annotations import json import os from unittest.mock import MagicMock, patch import pytest from typer.testing import CliRunner from honcho_cli.main import app @pytest.fixture def cfg(tmp_path, monkeypatch): """Isolated config file + clean HONCHO_* env.""" f = tmp_path / "config.json" monkeypatch.setattr("honcho_cli.config.CONFIG_DIR", tmp_path) monkeypatch.setattr("honcho_cli.config.CONFIG_FILE", f) monkeypatch.setattr("honcho_cli.commands.setup.CONFIG_FILE", f) for k in [k for k in os.environ if k.startswith("HONCHO_")]: monkeypatch.delenv(k) return f @pytest.fixture def runner(): return CliRunner() # --------------------------------------------------------------------------- # # 1. `honcho init` end-to-end class TestInit: def test_first_run_writes_exact_shape(self, cfg, runner): """First run with --api-key + --base-url writes apiKey + environmentUrl only.""" with patch("honcho_cli.commands.setup._test_connection", return_value=(True, "OK")): result = runner.invoke( app, ["init", "--api-key", "test-key-123", "--base-url", "http://localhost:8000"], ) assert result.exit_code == 0, result.stderr assert json.loads(cfg.read_text()) == { "environmentUrl": "http://localhost:8000", "apiKey": "test-key-123", } def test_preserves_foreign_keys(self, cfg, runner): """Second run must not clobber sibling-tool keys (`hosts`, `sessions`, ...).""" cfg.write_text(json.dumps({ "apiKey": "old", "environmentUrl": "http://old.example", "hosts": {"claude_code": {"peerName": "user"}}, "sessions": {"/Users/user": "home-chat"}, "sessionStrategy": "chat-instance", })) with patch("honcho_cli.commands.setup._test_connection", return_value=(True, "OK")): result = runner.invoke( app, ["init", "--api-key", "new-key", "--base-url", "https://api.honcho.dev"], ) assert result.exit_code == 0, result.stderr on_disk = json.loads(cfg.read_text()) assert on_disk["apiKey"] == "new-key" assert on_disk["environmentUrl"] == "https://api.honcho.dev" assert on_disk["hosts"] == {"claude_code": {"peerName": "user"}} assert on_disk["sessions"] == {"/Users/user": "home-chat"} assert on_disk["sessionStrategy"] == "chat-instance" # --------------------------------------------------------------------------- # # 2. Destructive-confirm guards class TestDestructiveConfirm: def test_workspace_delete_aborts_on_no(self, cfg, runner): """`workspace delete` without --yes: 'n' at prompt → no API call, non-zero exit.""" cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) fake = MagicMock() fake.sessions.return_value = MagicMock(has_next_page=lambda: False, _raw_items=[]) with patch("honcho_cli.commands.workspace.get_client", return_value=(fake, MagicMock())), \ patch("honcho_cli.commands.workspace._with_workspace", return_value=fake): result = runner.invoke(app, ["workspace", "delete", "ws1"], input="n\n") assert result.exit_code != 0 fake.delete_workspace.assert_not_called() def test_session_delete_aborts_on_no(self, cfg, runner): cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) session = MagicMock() client = MagicMock() client.session.return_value = session config = MagicMock(session_id="s1", workspace_id="ws1") with patch("honcho_cli.commands.workspace.get_client", return_value=(client, config)): result = runner.invoke(app, ["session", "delete", "s1"], input="n\n") assert result.exit_code != 0 session.delete.assert_not_called() # --------------------------------------------------------------------------- # # 3. JSON output contract — scripts pipe these class TestJsonContract: def test_workspace_list_json_array_shape(self, cfg, runner): cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) client = MagicMock() client.workspaces.return_value = ["ws-a", "ws-b"] with patch("honcho_cli.commands.workspace.get_client", return_value=(client, MagicMock())): result = runner.invoke(app, ["workspace", "list"]) assert result.exit_code == 0, result.stderr assert json.loads(result.stdout) == [{"id": "ws-a"}, {"id": "ws-b"}] def test_workspace_search_preserves_full_content_in_json_mode(self, cfg, runner): cfg.write_text(json.dumps({ "apiKey": "k", "environmentUrl": "http://localhost:8000", "workspace_id": "ws1", })) message = MagicMock( id="msg1", content="x" * 250, peer_id="peer1", session_id="sess1", created_at="2026-01-01T00:00:00Z", ) client = MagicMock() client.search.return_value = [message] config = MagicMock(workspace_id="ws1") with patch("honcho_cli.commands.workspace.get_client", return_value=(client, config)): result = runner.invoke(app, ["workspace", "search", "topic", "-w", "ws1"]) assert result.exit_code == 0, result.stderr payload = json.loads(result.stdout) assert payload == [{ "id": "msg1", "content": "x" * 250, "peer_id": "peer1", "session_id": "sess1", "created_at": "2026-01-01T00:00:00Z", }] def test_message_get_returns_single_json_object(self, cfg, runner): cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) msg = MagicMock( id="msg1", peer_id="peer1", content="hello", token_count=7, metadata={"kind": "demo"}, created_at="2026-01-01T00:00:00Z", ) session = MagicMock() session.get_message.return_value = msg client = MagicMock() client.session.return_value = session config = MagicMock(session_id="sess1", workspace_id="ws1") with patch("honcho_cli.commands.message.get_client", return_value=(client, config)): result = runner.invoke(app, ["message", "get", "msg1", "-s", "sess1", "-w", "ws1"]) assert result.exit_code == 0, result.stderr assert json.loads(result.stdout) == { "id": "msg1", "peer_id": "peer1", "content": "hello", "token_count": 7, "metadata": {"kind": "demo"}, "created_at": "2026-01-01T00:00:00Z", } # --------------------------------------------------------------------------- # # 4. Exit codes on error class TestExitCodes: def test_no_workspace_scoped_exits_nonzero_with_code(self, cfg, runner): """Running a workspace-scoped command with no workspace → NO_WORKSPACE on stderr, exit 1.""" cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) result = runner.invoke(app, ["peer", "list"]) assert result.exit_code == 1 assert json.loads(result.stderr)["error"]["code"] == "NO_WORKSPACE" def test_not_found_exits_nonzero_with_code(self, cfg, runner): """SDK NotFoundError → structured error, exit 1.""" from honcho import NotFoundError cfg.write_text(json.dumps({"apiKey": "k", "environmentUrl": "http://localhost:8000"})) client = MagicMock() client.peer.return_value.get_card.side_effect = NotFoundError("not found") config = MagicMock(peer_id="missing", session_id="", workspace_id="ws1") with patch("honcho_cli.commands.peer.get_client", return_value=(client, config)): result = runner.invoke(app, ["peer", "inspect", "missing", "-w", "ws1"]) assert result.exit_code == 1 assert json.loads(result.stderr)["error"]["code"] == "PEER_NOT_FOUND"