Improve API documentation and client UX

[jwalsh]

Product Manager Review (Jordan Taylor)

The current API implementation lacks clear documentation about response formats and the client interface doesn't provide enough flexibility for users.

API Documentation Issues

• No clear documentation of response format and structure
• Missing examples of how to use the API effectively
• No versioning information in health endpoint

Client UX Improvements

• Add option to export analysis results in different formats (JSON, CSV, etc.)
• Support saving results to file
• Add configurable output formatting
• Improve error handling with better user feedback

Expected Outcome

Better developer experience with clear documentation and more flexible client interface that meets real-world usage needs.