feat: trading feedback engine — periodic performance reports with AI summarization

- Migration 038: trading_reports table + report-summarizer agent seed
- 6 reporting modules: models, collector, sections, validator, summarizer, generator
- API endpoints: GET /api/reports (paginated, filterable), GET /api/reports/{id}
- Frontend hooks: useReports, useReport with TanStack Query
- Scheduler: daily (after 16:30 ET) and weekly (Saturday) report triggers
- Redis queue consumer for async report generation with retry/dedup
- 5 property-based tests (chunking, serialization, validation, accuracy, deltas)
- 109 unit/integration tests across all modules
- 6 frontend hook tests with MSW mocks

services/api/app.py

@@ -4107,3 +4107,112 @@ async def get_validation_attribution_layers(
         "lookback": lookback,
         "horizon": horizon,
     }
+
+
+# ---------------------------------------------------------------------------
+# Trading Reports
+# ---------------------------------------------------------------------------
+
+
+@app.get("/api/reports")
+async def list_reports(
+    report_type: Optional[str] = None,
+    start_date: Optional[str] = None,
+    end_date: Optional[str] = None,
+    limit: int = Query(default=20, le=100),
+    offset: int = Query(default=0, ge=0),
+):
+    """Paginated list of trading reports with optional filtering.
+
+    Query params:
+    - report_type: 'daily' or 'weekly'
+    - start_date: ISO date (YYYY-MM-DD) — filter period_start >= this
+    - end_date: ISO date (YYYY-MM-DD) — filter period_end <= this
+    - limit: max results (default 20, max 100)
+    - offset: pagination offset (default 0)
+
+    Requirements: 5.4, 5.5, 5.6
+    """
+    conditions: list[str] = []
+    params: list[Any] = []
+    idx = 1
+
+    if report_type:
+        if report_type not in ("daily", "weekly"):
+            raise HTTPException(400, "report_type must be 'daily' or 'weekly'")
+        conditions.append(f"report_type = ${idx}")
+        params.append(report_type)
+        idx += 1
+
+    if start_date:
+        try:
+            from datetime import date as _date
+            _date.fromisoformat(start_date)
+        except ValueError:
+            raise HTTPException(400, "start_date must be YYYY-MM-DD")
+        conditions.append(f"period_start >= ${idx}::date")
+        params.append(start_date)
+        idx += 1
+
+    if end_date:
+        try:
+            from datetime import date as _date
+            _date.fromisoformat(end_date)
+        except ValueError:
+            raise HTTPException(400, "end_date must be YYYY-MM-DD")
+        conditions.append(f"period_end <= ${idx}::date")
+        params.append(end_date)
+        idx += 1
+
+    where = f"WHERE {' AND '.join(conditions)}" if conditions else ""
+
+    query = f"""
+        SELECT id, report_type, period_start, period_end,
+               validation_status, generated_at
+        FROM trading_reports
+        {where}
+        ORDER BY generated_at DESC
+        LIMIT ${idx} OFFSET ${idx + 1}
+    """
+    params.extend([limit, offset])
+
+    rows = await pool.fetch(query, *params)
+    return [
+        {
+            "id": str(r["id"]),
+            "report_type": r["report_type"],
+            "period_start": r["period_start"].isoformat(),
+            "period_end": r["period_end"].isoformat(),
+            "validation_status": r["validation_status"],
+            "generated_at": r["generated_at"].isoformat(),
+        }
+        for r in rows
+    ]
+
+
+@app.get("/api/reports/{report_id}")
+async def get_report(report_id: str):
+    """Fetch a single report including full report_data JSONB.
+
+    Requirements: 5.4, 5.5
+    """
+    row = await pool.fetchrow(
+        """SELECT id, report_type, period_start, period_end,
+                  report_data, validation_status, generated_at, created_at
+           FROM trading_reports
+           WHERE id = $1::uuid""",
+        report_id,
+    )
+    if row is None:
+        raise HTTPException(404, "Report not found")
+
+    return {
+        "id": str(row["id"]),
+        "report_type": row["report_type"],
+        "period_start": row["period_start"].isoformat(),
+        "period_end": row["period_end"].isoformat(),
+        "report_data": json.loads(row["report_data"]) if isinstance(row["report_data"], str) else row["report_data"],
+        "validation_status": row["validation_status"],
+        "generated_at": row["generated_at"].isoformat(),
+        "created_at": row["created_at"].isoformat(),
+    }