feat(tasks): define investigation report contract and history

app/api/v1/endpoints/operational_tasks.py

@@ -50,6 +50,8 @@ from app.domain.schemas.operational_task import (
     ExternalSourceWithdrawalCommand,
     HumanApprovalAction,
     HumanEvidenceCommand,
+    InvestigationReportPage,
+    InvestigationReportRevision,
     NotificationAcknowledgeCommand,
     OperationalTaskCreate,
     OperationalTaskDetail,
@@ -100,6 +102,34 @@ def _raise_domain(exc: DomainError):
     raise HTTPException(status_code=exc.status, detail=exc.payload()) from exc
 
 
+@router.get("/operational-tasks/{task_id}/reports", response_model=InvestigationReportPage)
+async def list_investigation_reports(
+    task_id: UUID,
+    limit: int = Query(default=20, ge=1, le=100),
+    offset: int = Query(default=0, ge=0),
+    ctx: ProjectContext = Depends(require_permission(OPERATIONAL_TASK_VIEW)),
+    conn: AsyncConnection = Depends(get_project_pg_connection),
+):
+    try:
+        items, next_offset = await _service(ctx, conn).list_reports(task_id, limit, offset)
+        return InvestigationReportPage(items=items, next_offset=next_offset)
+    except DomainError as exc:
+        _raise_domain(exc)
+
+
+@router.get("/operational-tasks/{task_id}/reports/{revision}", response_model=InvestigationReportRevision)
+async def get_investigation_report(
+    task_id: UUID,
+    revision: int,
+    ctx: ProjectContext = Depends(require_permission(OPERATIONAL_TASK_VIEW)),
+    conn: AsyncConnection = Depends(get_project_pg_connection),
+):
+    try:
+        return await _service(ctx, conn).report(task_id, revision)
+    except DomainError as exc:
+        _raise_domain(exc)
+
+
 @router.post(
     "/operational-tasks",
     response_model=OperationalTaskDetail,
@@ -417,11 +447,12 @@ async def record_operational_task_run_dispatch_failure(
 )
 async def get_operational_task_agent_context(
     task_id: UUID,
+    report_revision: int | None = Query(default=None, ge=1),
     ctx: ProjectContext = Depends(require_permission(OPERATIONAL_TASK_VIEW)),
     conn: AsyncConnection = Depends(get_project_pg_connection),
 ):
     try:
-        return await _service(ctx, conn).agent_context(task_id)
+        return await _service(ctx, conn).agent_context(task_id, report_revision)
     except DomainError as exc:
         _raise_domain(exc)