b96c556701
* feat(workbench): add practice evidence read model * feat(workbench): add practice evidence endpoint seam * feat(workbench): persist practice evidence field when present * test(workbench): cover practice evidence read model seam
57 lines
1.6 KiB
Python
57 lines
1.6 KiB
Python
"""Narrow sealed-practice evidence endpoint seam for Workbench.
|
|
|
|
The helper is read-only and projects only persisted practice evidence through
|
|
`practice_evidence_from_journal_entry`. It never runs geometric search, replay,
|
|
operator execution, or trace sealing.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from typing import Any
|
|
|
|
from workbench.practice_evidence import practice_evidence_from_journal_entry
|
|
from workbench.schemas import error, ok
|
|
|
|
|
|
@dataclass(frozen=True, slots=True)
|
|
class PracticeEndpointResponse:
|
|
status: int
|
|
payload: dict[str, Any]
|
|
|
|
|
|
def practice_evidence_response(
|
|
journal: Any,
|
|
raw_turn_id: str,
|
|
) -> PracticeEndpointResponse:
|
|
"""Return JSON-envelope payload for `/trace/<turn_id>/practice`."""
|
|
|
|
try:
|
|
turn_id = int(raw_turn_id)
|
|
except ValueError:
|
|
return PracticeEndpointResponse(
|
|
404,
|
|
error("not_found", f"trace practice not found: {raw_turn_id}"),
|
|
)
|
|
|
|
try:
|
|
entry = journal.get_entry(turn_id)
|
|
except FileNotFoundError:
|
|
return PracticeEndpointResponse(
|
|
404,
|
|
error("not_found", f"trace practice not found: {turn_id}"),
|
|
)
|
|
|
|
return PracticeEndpointResponse(
|
|
200,
|
|
ok(practice_evidence_from_journal_entry(entry)),
|
|
)
|
|
|
|
|
|
def practice_turn_id_from_path(path: str) -> str | None:
|
|
"""Extract raw turn id from `/trace/<turn_id>/practice`."""
|
|
|
|
if not (path.startswith("/trace/") and path.endswith("/practice")):
|
|
return None
|
|
raw = path.removeprefix("/trace/").removesuffix("/practice").strip("/")
|
|
return raw or None
|