improve docs test

[deathbyknowledge]

docs are non-existing or stale

[deathbyknowledge]

@docbrown-dev improve docs so they match the latest state of the repo

[drdoc-bot]

On it — I'll analyze the repo and update the docs to match the current state.

[drdoc-bot]

Documentation updated! See PR #13 for the changes.

Summary:

• Fixed command syntax error (sos session -i → --image)
• Added missing CLI flags: --timeout, --formatted, --remove
• Completed HTTP API docs (all response fields and parameters)
• Added version number (v0.0.7) and enhanced usage examples
• Added "How It Works" section explaining key concepts

All changes verified against the actual source code.