Testing and Quality¶
Existing tests¶
The repository includes service/API tests, path-guard tests, and snapshot-workspace tests. The path tests are especially important because archive and file routes share the same containment helper. The README documents uv run pytest and the frontend production build.
Quality matrix¶
| Area | Current signal | Needed next |
|---|---|---|
| Path safety | Dedicated tests | Symlink/archive fuzzing |
| Sessions | Service tests | Crash/restart and concurrent heartbeat tests |
| Runtime | Adapter code | Fake runtime contract tests |
| Snapshots | Workspace tests | Real microsandbox integration |
| Frontend | TypeScript/Vite build | Browser workflow tests |
| Operations | Health/readiness routes | Multi-instance and disk-pressure tests |
The most valuable contract test would run the same session/exec/file/snapshot scenario against both runtime implementations using a fake or disposable backend.