docs: comprehensive README update

[drdoc-bot]

Summary

This PR provides a comprehensive update to the README.md for the Sea of Simulation (SoS) project, as requested in issue #8.

Changes Made

New Sections Added

• Quick Start Guide - Simple examples to get users up and running immediately
• Detailed Installation - From source, binaries, and cargo with Docker/Podman setup notes
• Complete CLI Usage - All commands explained with examples (create, list, start, exec, trajectory, stop)
• Interactive Session Mode - REPL-like interface documentation
• TUI Mode Documentation - Full Terminal UI guide with all screens and keyboard shortcuts
• HTTP API Reference - Complete REST API documentation with all endpoints, request/response examples
• Python Client Integration - Example code showing how to use SoS from Python
• Examples Section - RL training and synthetic data generation examples
• Development Guide - Project structure, testing, benchmarks, cross-platform builds
• Configuration - Server and client configuration options
• Architecture - Sandbox lifecycle, concurrency control, session vs standalone execution
• Troubleshooting - Common issues and solutions
• Contributing Guidelines - How to contribute to the project

Improvements

• Better organization and structure
• Clear code examples throughout
• Comprehensive tables for CLI options, TUI shortcuts, API endpoints
• Proper markdown formatting with headers, code blocks, and tables
• Cross-references between related sections
• Added CI badge

Key Features Highlighted

• Server, CLI, and TUI modes
• Concurrent sandbox management
• Session persistence and trajectory tracking
• HTTP API for programmatic access
• Python client library
• Cross-platform support (Linux, macOS, multiple architectures)

Testing

The documentation is based on the actual codebase structure and verified against:

• Cargo.toml for dependencies and features
• Source code in src/cli/main.rs and src/cli/tui.rs
• API implementation in src/lib/http.rs
• Examples in examples/rl/ and examples/synthetic_generator/
• Existing Python client in examples/rl/sos.py

Related Issue

Closes #8