Files
roboco/tests/unit/api/routes/v1/test_verb_rejection_logging.py
T

61 lines
2.1 KiB
Python
Raw Normal View History

"""A rejected envelope must leave a server-side trace.
An error envelope rides a 200, so the access log cannot distinguish a verb an
agent could not satisfy from one that worked. Four Board Programs died that
way on 2026-07-25 with no recoverable reason.
"""
from __future__ import annotations
from typing import Any
from unittest.mock import MagicMock
from roboco.api.routes.v1._role_dep import envelope_to_response
from roboco.services.gateway.envelope import Envelope
from structlog.testing import capture_logs
def _request(path: str) -> MagicMock:
request = MagicMock()
request.url.path = path
request.state.correlation_id = "cid-1"
request.headers = {"X-Agent-ID": "agent-7", "X-Agent-Role": "head_marketing"}
return request
def _captured(env: Envelope, path: str) -> list[Any]:
"""``capture_logs`` rather than a hand-rolled processor swap — it is
independent of whatever global structlog config the rest of the suite has
already installed, which made the swap pass alone and fail in-suite."""
with capture_logs() as entries:
envelope_to_response(env=env, request=_request(path))
return [e for e in entries if e.get("event") == "verb rejected"]
def test_rejection_logs_reason_and_remediation() -> None:
env = Envelope.invalid_state(
message="finding 0 is missing 'source_url' — an uncited market claim is noise",
remediate="provide the http(s) source URL finding 0's claim came from",
context_briefing={},
)
entries = _captured(env, "/api/v1/do/propose_market_brief")
assert len(entries) == 1, entries
logged = entries[0]
assert logged["verb"] == "propose_market_brief"
assert logged["error"]
assert "source_url" in str(logged["detail"])
assert "http(s) source URL" in str(logged["remediate"])
assert logged["agent_id"] == "agent-7"
assert logged["agent_role"] == "head_marketing"
def test_success_envelope_logs_nothing() -> None:
env = Envelope.ok(
status="market_brief_proposed",
task_id="t-1",
next="i_am_idle()",
context_briefing={},
)
assert _captured(env, "/api/v1/do/propose_market_brief") == []