Release Notes — v0.1.0
TDES (Transport, Delivery, and Evaluation System)
Release Date: July 2025
Highlights
First release of TDES — a pluggable system for packaging, distributing, submitting, and automatically grading coding lab exercises. Ships with a fully end-to-end offline flash-drive workflow, an online registry server transport, Docker-sandboxed evaluation, encrypted submissions, and an embedded Web UI.
Student CLI
| Command |
Status |
euc2 init <id[@ver]> <dir> — Initialize workspace from local cache |
Complete |
euc2 fetch <id> --drive <path> — Fetch exercise from USB drive (offline) |
Complete |
euc2 fetch <id> --remote <url> — Fetch exercise from registry server (online) |
Complete |
euc2 run — Run public tests in Docker sandbox |
Complete |
euc2 run --local — Run public tests on host |
Complete |
euc2 submit --drive <path> — Encrypted submission to USB drive |
Complete |
euc2 submit --remote <url> — Submit to server with TOFU PIN auth |
Complete |
euc2 submit --update-pin <pin> — Rotate student PIN |
Complete |
euc2 evaluate <submission.tar> — Grade locally in Docker (auto-pulls private tests) |
Complete |
Drive-Based Admin CLI
| Command |
Status |
euc2 drive prepare <path> — Initialize drive directory structure |
Complete |
euc2 drive add-exercise <path> <id> <ver> — Copy exercise onto drive |
Complete |
euc2 drive prepare-submission <path> — Configure drive with X25519 recipient key |
Complete |
euc2 drive decrypt-submission <envelope> — Decrypt a single submission envelope |
Complete |
euc2 drive evaluate-batch <path> — Decrypt and grade all submissions, export CSV/JSON |
Complete |
Exercise Authoring CLI
| Command |
Status |
euc2 package <dir> — Validate reference solution, split public/private packages |
Complete |
euc2 publish <dir> --remote <url> — Package and upload to registry server |
Complete |
Server Admin CLI
| Command |
Status |
euc2 admin onboard-students <csv> — Upload student roster for TOFU activation |
Complete |
euc2 admin get-grades — Retrieve grades (stdout / --csv / --json) |
Complete |
Registry Server API
| Endpoint |
Status |
GET /healthz — Health check |
Complete |
POST /v1/exercises/publish — Upload exercise packages |
Complete |
GET /v1/exercises — List exercises (filterable) |
Complete |
GET /v1/exercises/{org}/{id}/versions — List versions |
Complete |
GET /v1/exercises/{org}/{id}/versions/{ver} — Version metadata |
Complete |
GET /v1/exercises/{org}/{id}/versions/{ver}/download — Download artifact |
Complete |
POST /v1/exercises/{org}/{id}/versions/{ver}/status — Update version status |
Complete |
DELETE /v1/exercises/{org}/{id}/versions/{ver} — Delete version |
Complete |
GET /v1/artifacts/{sha256} — Download by content hash |
Complete |
POST /v1/submissions — Student submission + sandbox evaluation |
Complete |
GET /v1/submissions — Query grades (JSON/CSV) |
Complete |
POST /v1/admin/onboard — Upload student roster |
Complete |
Web UI (euc2 ui)
| Feature |
Status |
| Monaco code editor with file tree |
Complete |
| Docker / local test runner with live output |
Complete |
| Multi-step submit wizard (drive + remote) |
Complete |
| Admin drive management & batch evaluator |
Complete |
| X25519 keypair generator |
Complete |
| CSV report export |
Complete |
Known Limitations
euc2 new-exercise (scaffold templates) — not yet implemented- Server uses bearer token auth — role-based access control planned for future release
