Export API documentation from code to README
Update vows and prompt dependencies

Versions depended on are years old, and both have improved a lot,
vows in particular supports xunit output.