add readOptions()

implied serviceOptions interface
minor refactor
version bump
remove list() synonym