# WASPL TestRunner — Features Index Page

_Generated by Codex — version wiki pastel (compatible BookStack)_

---

## 01 — Access & Publication Hub
<span style="color:#7EC8E3;">Entry point for learners (login, publication overview, instructions)</span>  
**Domain:** `waspltestrunner/access`

- **0101 Authentication & token guard** — Login view + Pinia auth store, JWT decoding, re-auth on expiry  
- **0102 Publication dashboard** — Learner publication list with mode badges & adaptive/branch tags  
- **0103 Session eligibility tracking** — Evaluates sessionStatuses for attempts, retries & agent detection  
- **0104 Start session modal** — Preparation modal with adaptive visuals & student greeting  
- **0105 Instruction list generator** — Dynamic checklist (time limit, skip policy, adaptive cues)  
- **0106 Access info modal** — Explains locked/expired publications  
- **0107 Multi-language pack** — vue-i18n setup with six locale JSON bundles  

---

## 02 — Linear Test Delivery
<span style="color:#A9C5F2;">Standard test flow with navigation, validation, timer and completion feedback</span>  
**Domain:** `waspltestrunner/runner/linear`

- **0201 Test runner orchestrator** — Handles loading, navigation & submission flow  
- **0202 Test renderer & layout engine** — Renders pages (stimulus, layouts, toasts)  
- **0203 Student toolbar & timer** — Navbar with institution info & persistent countdown  
- **0204 Interactive test map** — Visual question overview enforcing skip policy  
- **0205 Response persistence store** — Pinia store syncing responses with localStorage  
- **0206 Completion & AI feedback page** — Summary, AI correction workflow, messages  
- **0207 Navigation composables** — Utilities for page sequencing & question indexing  

---

## 03 — Adaptive Test Delivery
<span style="color:#9AB8F5;">CAT execution pipeline with engine, analytics and result packaging</span>  
**Domain:** `waspltestrunner/runner/adaptive`

- **0301 Adaptive runner & CAT engine** — Integrates catEngine with TestRenderer  
- **0302 CAT progress analytics** — Tracks level progress, success/failure rates  
- **0303 Adaptive result packaging** — Validates CAT data & posts to `/results`  
- **0304 Adaptive preview pipeline** — Loads CAT tests in read-only preview mode  
- **0305 CAT data processor** — Structures metrics (levels, paths, ability)  

---

## 04 — Conditional Test Delivery
<span style="color:#C9B6E4;">Branching test runtime with graph navigation and preview support</span>  
**Domain:** `waspltestrunner/runner/conditional`

- **0401 Conditional runner orchestrator** — Loads conditional structures, manages sessions  
- **0402 Conditional navigation engine** — Computes next nodes, path history, scoring logic  
- **0403 Conditional renderer & page nodes** — Dynamic rendering with validation  
- **0404 Conditional structure loader** — Fetches secured ConditionalStructure via API  
- **0405 Conditional preview pipeline** — Read-only preview wrapper for conditional tests  

---

## 05 — Interaction Engine
<span style="color:#A8E6CF;">Dynamic interaction factory covering WASPL item types</span>  
**Domain:** `waspltestrunner/interactions`

- **0501 Interaction factory** — Glob-import loader per `el_Type`  
- **0502 Choice & choice block** — Single/multi choice rendering with scoring hooks  
- **0503 Text gaps & puzzles** — Cloze/puzzle handling with indexed mapping  
- **0504 Matching & pairing** — Drag-drop persistence for matching & pairs  
- **0505 Hot spot interaction** — Konva-based image hotspot renderer  
- **0506 Short answer integration** — AI/manual scoring support  

---

## 06 — Runtime Services & Automation
<span style="color:#F9C6D0;">Shared services for sessions, results, dimensions and agent automation</span>  
**Domain:** `waspltestrunner/runtime`

- **0601 Session lifecycle manager** — Starts/locks/ends sessions with access rules  
- **0602 Result sender & dimension enricher** — Posts enriched structured payloads  
- **0603 Dimension enrichment utilities** — Maps IDs to dimension descriptors  
- **0604 Agent response planner** — Configurable success-rate planner (A/B/C agents)  
- **0605 LM Studio bridge** — Calls LM Studio & feeds scoring pipeline  
- **0606 Response pre-generator** — Generates agent answers for simulations  

---

## 07 — Preview & QA Toolkit
<span style="color:#FFF3B0;">Tools for previewing tests, capturing snapshots and diagnosing setups</span>  
**Domain:** `waspltestrunner/tools`

- **0701 Linear test previewer** — Loads tests via preview tokens  
- **0702 Adaptive previewer** — Wraps CAT runner in preview mode  
- **0703 Conditional previewer** — Preview for conditional tests with token flow  
- **0704 Snapshot capture demos** — HTML2Canvas/Konva snapshot rendering  
- **0705 Debug panel** — Floating console testing auth/API/logs  
- **0706 Diagnostics helpers** — Console utilities for quick checks