Tutor Platform Changelog

Unreleased (2026-03-12)

Features

Questions admin capability pages — Added frontend routes and UI flows for grader and answer management under Configuration (/configuration/questions/graders, /configuration/questions/answers)
Question grading UX alignment — Updated grader form and hooks to match backend schema (agent_id, dimension, deployment)
Frontend accessibility polish — Improved layout-level accessibility and navigation consistency on key pages

Compatibility & Reliability

Retry semantics hardened — Shared Foundry and Cosmos retry policies now preserve non-transient exceptions and retry only transient failures (network/timeout/429/5xx)
API error contract stabilization — Exception mappings across questions/configuration/essays narrowed to explicit not-found handling to avoid false 404 responses
Assembly repository abstraction — Questions and essays orchestrators now use shared assembly repository access patterns
Avatar speech config lifecycle — Speech broker initialization supports lazy configuration and clearer runtime validation

CI/CD & Operations

Deploy guardrails workflow fix — Corrected Azure Container Apps environment variable wiring for post-deploy guardrail checks
Dependency lock refresh — Added/updated service lockfiles for questions/configuration/upskilling and refreshed existing locks for avatar/essays

Tests & Quality

Orchestrator tests updated — Essays orchestrator tests aligned with repository-based assembly loading path
Validation status — Targeted backend suites and frontend TypeScript checks pass after the compatibility updates

Features

OCR Phase A — Document Intelligence SDK integration in essays service (file_processing.py), with pypdf/PIL fallback for local development (ADR-006)
Essay PATCH endpoint — PATCH /essays/{essay_id} for partial updates using EssayPatch model with exclude_unset=True
Upskilling stateful transformation — full CRUD plan management with Cosmos DB persistence (upskilling_plans container, PK /professor_id), multi-agent evaluation, repository pattern (InMemoryUpskillingRepository, CosmosUpskillingRepository)
Configuration UIs — admin pages for Agents, Upskilling, Evaluation, and LMS Gateway under /configuration
Avatar speech auth — DefaultAzureCredential for Azure Speech in avatar service
Demo seed script — scripts/seed_demo_data.py provisions 90 items across all services with essay↔assembly linkage via PATCH
APIM alignment — all frontend traffic routed through APIM; backend endpoints normalized across chat, questions, essays, avatar, configuration
Showcase navigation — homepage and sidebar include upskilling, evaluation, and lms-gateway pages
Theme management — configuration service exposes GET/POST/PUT/DELETE /themes

Bug Fixes

Essay assembly linkage — update_essay PUT no longer destructively overwrites assembly_id with None; incoming payload filtered for non-None values before merge
Seed script re-link — link_essays_to_assemblies() step uses PATCH to bind essays to assemblies after initial seeding
Test stub drift — fixed 4 pre-existing test failures in test_essays_orchestrator.py (stubs updated for fallback_essay_id, attachments, essay_id)
Frontend SWA deployment — GitHub Actions workflow fixed for Oryx managed build

Infrastructure

Breaking Changes