Manual Testing Playbook
Complete feature-by-feature testing guide with expected behavior for every RUSVEL surface.
RUSVEL exposes 6 surfaces — each needs manual verification:
| Surface | Entry point | Requires Ollama |
|---|---|---|
| CLI One-Shot | cargo run -- <command> | Some commands |
| REPL Shell | cargo run -- shell | No |
| TUI Dashboard | cargo run -- --tui | No |
| Web API | curl localhost:3000/api/* | Chat endpoints |
| Web Frontend | Browser at localhost:3000 | Chat pages |
| MCP Server | cargo run -- --mcp | Some tools |
Testing Strategy
- Start with the Smoke Test Checklist — 30 steps, covers all surfaces in ~15 minutes
- Deep-dive per surface — Use the dedicated pages for thorough testing
- Engine-specific tests — Code, Content, Harvest, GTM, Flow each have unique endpoints
- Cross-surface verification — Perform an action in one surface, verify it in another:
- Create a session via CLI -> verify via
curl /api/sessions-> verify in browser UI - Chat via web UI -> verify conversation via API -> check events in TUI
- Create a session via CLI -> verify via
Quick Reference
| What | Where |
|---|---|
| Build & prerequisites | Setup |
| CLI, REPL, TUI | CLI Testing |
| REST API (130+ routes) | API Testing |
| Browser UI (30+ pages) | Frontend Testing |
| Code, Content, Harvest, GTM, Flow | Engine Testing |
| 30-step release gate | Smoke Checklist |