# WASPL Test Runner Features index

This is a guide for testing app

# 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 &amp; token guard** — Login view + Pinia auth store, JWT decoding, re-auth on expiry
- **0102 Publication dashboard** — Learner publication list with mode badges &amp; adaptive/branch tags
- **0103 Session eligibility tracking** — Evaluates sessionStatuses for attempts, retries &amp; agent detection
- **0104 Start session modal** — Preparation modal with adaptive visuals &amp; 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 &amp; submission flow
- **0202 Test renderer &amp; layout engine** — Renders pages (stimulus, layouts, toasts)
- **0203 Student toolbar &amp; timer** — Navbar with institution info &amp; persistent countdown
- **0204 Interactive test map** — Visual question overview enforcing skip policy
- **0205 Response persistence store** — Pinia store syncing responses with localStorage
- **0206 Completion &amp; AI feedback page** — Summary, AI correction workflow, messages
- **0207 Navigation composables** — Utilities for page sequencing &amp; 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 &amp; CAT engine** — Integrates catEngine with TestRenderer
- **0302 CAT progress analytics** — Tracks level progress, success/failure rates
- **0303 Adaptive result packaging** — Validates CAT data &amp; 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 &amp; 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 &amp; choice block** — Single/multi choice rendering with scoring hooks
- **0503 Text gaps &amp; puzzles** — Cloze/puzzle handling with indexed mapping
- **0504 Matching &amp; pairing** — Drag-drop persistence for matching &amp; pairs
- **0505 Hot spot interaction** — Konva-based image hotspot renderer
- **0506 Short answer integration** — AI/manual scoring support

---

## 06 — Runtime Services &amp; 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 &amp; 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 &amp; feeds scoring pipeline
- **0606 Response pre-generator** — Generates agent answers for simulations

---

## 07 — Preview &amp; 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