test(fase2): end-to-end vertical-slice integration suite

tests/conftest.py

@@ -0,0 +1,107 @@
+"""Shared e2e fixtures (Step 13): a scripted chat client that emits a SYNTHETIC UsageDetails
+(so token accounting is real-shaped without an LLM), plus store + docs-dir fixtures.
+
+The synthetic ``UsageDetails`` is what lets the budget meter / provenance ``token_usage`` be a
+positive, UsageDetails-sourced number in CI — the REAL-provider populated-usage assertion is
+the gated live arm (Step 14).
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Sequence
+from typing import Any
+
+import pytest
+from agent_framework import (
+    BaseChatClient,
+    ChatResponse,
+    ChatResponseUpdate,
+    Message,
+    UsageDetails,
+)
+
+from portfolio_optimiser.verdicts import VerdictStore, seed_store
+
+
+class SyntheticUsageChatClient(BaseChatClient):
+    """Network-free chat client returning scripted/default replies WITH a synthetic
+    ``UsageDetails`` (``total_token_count``), so strict usage accounting does not hard-fail."""
+
+    OTEL_PROVIDER_NAME = "synthetic"
+
+    def __init__(
+        self,
+        scripted: Sequence[str] | None = None,
+        *,
+        default_reply: str = "ok",
+        tokens_per_reply: int = 8,
+    ) -> None:
+        super().__init__()
+        self._scripted = list(scripted or [])
+        self._idx = 0
+        self._default = default_reply
+        self._tokens = tokens_per_reply
+        self.call_count = 0
+
+    def _next_reply(self) -> str:
+        reply = self._scripted[self._idx] if self._idx < len(self._scripted) else self._default
+        self._idx += 1
+        self.call_count += 1
+        return reply
+
+    def _inner_get_response(
+        self, *, messages: Sequence[Message], stream: bool, options: Any, **kwargs: Any
+    ) -> Any:
+        reply = self._next_reply()
+        usage = UsageDetails(total_token_count=self._tokens)
+        if stream:
+
+            async def _agen() -> Any:
+                yield ChatResponseUpdate(
+                    role="assistant", contents=[{"type": "text", "text": reply}]
+                )
+
+            return self._build_response_stream(_agen())
+
+        async def _coro() -> ChatResponse:
+            return ChatResponse(
+                messages=[Message(role="assistant", contents=[reply])],
+                response_id="synthetic",
+                usage_details=usage,
+            )
+
+        return _coro()
+
+
+@pytest.fixture()
+def make_client_factory() -> Callable[..., Callable[[str], BaseChatClient]]:
+    """Return a maker that builds a per-role client factory emitting synthetic usage."""
+
+    def _make(default_reply: str, *, tokens: int = 8) -> Callable[[str], BaseChatClient]:
+        def factory(role: str) -> BaseChatClient:
+            return SyntheticUsageChatClient(default_reply=default_reply, tokens_per_reply=tokens)
+
+        return factory
+
+    return _make
+
+
+@pytest.fixture()
+def fresh_store() -> VerdictStore:
+    return VerdictStore(verdicts=[])
+
+
+@pytest.fixture()
+def seeded_store() -> VerdictStore:
+    return seed_store()
+
+
+@pytest.fixture()
+def docs_dir(tmp_path) -> str:
+    d = tmp_path / "docs"
+    d.mkdir()
+    (d / "cost.txt").write_text(
+        "Asphalt Ab11 unit rate renegotiation reduced the paving cost on the school stretch.",
+        encoding="utf-8",
+    )
+    return str(d)