ec397f2c65
v0.5 (Live Assist — on-the-job voice companion) milestone complete. 4 phases: P0 (pre-execution, v0.1.10) → P1 (assist core + guardrail, v0.1.11) → P2 (integration + tech-debt + NFR, v0.1.12) → P3 (final review + ship, v0.1.13 = milestone release). 16/16 REQs covered (3 ASSIST + 4 NFR + 9 IDEATE). 4 v0.6 backlog. 469 tests passed, 0 failed. 1 P0 fixed (guardrail processor safety). 8 P1+ flagged for v0.6. 8 v0.4 P1+ tech-debt addressed. G-049 + G-067 grill MUSTs resolved. ESCALATION-01 (PIPEDA) OPEN for human legal review before assist surface go-live. ---ci--- project: praxis phase: 3 milestone: v0.5 status: complete requirements: covered: [REQ-ASSIST-01, REQ-ASSIST-02, REQ-ASSIST-03, REQ-NFR-ASSIST-01, REQ-NFR-ASSIST-02, REQ-NFR-ASSIST-03, REQ-NFR-ASSIST-04, REQ-IDEATE-01, REQ-IDEATE-02, REQ-IDEATE-03, REQ-IDEATE-04, REQ-IDEATE-05, REQ-IDEATE-06, REQ-IDEATE-07, REQ-IDEATE-08, REQ-IDEATE-09] partial: [] ---/ci---
53 lines
1.9 KiB
Python
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"] |