Files
praxis/server/operator/mastery.py
T
Praxis CI bdcf793db2 feat(P02): complete integration + tech-debt + NFR measurement phase — v0.1.12 tagged
Phase 2 (Integration + Tech-Debt + NFR Measurement) complete.
4 slices, 2 waves, 9 tasks. 4 REQs covered. 60 new tests (469 total).
8 v0.4 P1+ tech-debt findings addressed. Verify: APPROVE_WITH_NOTES.

NFR measurement (p95 latency + guardrail FP/FN), cohort aggregation
assist metrics (5 new metrics, no schema change), assist cost tracking
+ C-3 budget check, tech-debt wave (argon2id offload, cookie-secret
validation, credential enum, f-string SQL, cache persistence, zoneinfo,
audit log, 429 mock).

---ci---
project: praxis
phase: 2
milestone: v0.5
status: complete
requirements:
  covered: [REQ-NFR-ASSIST-01, REQ-IDEATE-04, REQ-IDEATE-06, REQ-IDEATE-07]
  partial: []
---/ci---
2026-08-04 22:11:51 +00:00

53 lines
1.9 KiB
Python

"""GET /api/operator/mastery — mastery progression view (TASK-08-02, D-053, D-063).
Auth-gated. Returns mastery progression metrics: gate_open_rate,
median_mastery_score, rubric_criterion_means (cells with metric prefix
`rubric_criterion_mean:`). All k-anonymized (suppressed if < 10).
D-063 (binding): assist does NOT update mastery. This view is unchanged from
v0.4 — assist metrics (assist_shifts_count, assist_turns_count) are NOT
mastery metrics and are NOT included here. They appear in the cohort view
(TASK-10-02). The assist metrics are separate from practice/mastery metrics.
"""
from __future__ import annotations
import datetime as _dt
from fastapi import APIRouter, Depends, Request
from server.auth.dependencies import current_operator
from server.auth.models import Operator
from server.operator._common import (
ViewResponse,
all_recent_aggregates,
group_by_path,
require_pg_store,
)
router = APIRouter(prefix="/api/operator", tags=["operator-mastery"])
MASTERY_METRICS = {"gate_open_rate", "median_mastery_score"}
def _is_mastery_metric(metric: str) -> bool:
# D-063: assist metrics are NOT mastery metrics. Only practice mastery
# metrics (gate_open_rate, median_mastery_score, rubric_criterion_mean:*)
# are included in this view.
return metric in MASTERY_METRICS or metric.startswith("rubric_criterion_mean:")
@router.get("/mastery", response_model=ViewResponse)
async def mastery_view(
request: Request,
op: Operator = Depends(current_operator),
) -> ViewResponse:
pg_store = await require_pg_store(request)
since = _dt.date.today() - _dt.timedelta(days=30)
rows = await all_recent_aggregates(pg_store, since)
mastery_rows = [r for r in rows if _is_mastery_metric(r.get("metric", ""))]
views, last_updated = group_by_path(mastery_rows)
return ViewResponse(views=views, last_updated=last_updated)
__all__ = ["router"]