docs: update README to match v0.0.7 state of codebase

[drdoc-bot]

Overview

Updated the README.md documentation to accurately reflect the current state of the codebase (v0.0.7).

Changes

Fixed Issues

• Command syntax error: Changed sos session -i to sos session --image (the -i flag doesn't exist)
• Typo: Removed extra space in sos sandbox --server example

Added Documentation

• Version number: Added v0.0.7 to the header
• Missing CLI flags:
  • --timeout SECONDS for sos serve (default: 600s)
  • --formatted / -f for sos sandbox trajectory
  • --remove / -r for sos sandbox stop

Complete HTTP API Reference

• Added GET /sandboxes/{id}/trajectory/formatted endpoint
• Documented all SandboxInfo response fields:
  • id, status, image, setup_commands, session_command_count, last_standalone_exit_code
  • created_at, started_at, stopped_at, container_id
• Documented CommandResult fields including the exited boolean
• Documented request parameters (timeout, remove, standalone, image, setup_commands)

Enhanced Usage Examples

• Added "How It Works" section explaining:
  • Session vs standalone execution modes
  • Concurrency control (10 sandbox default)
  • Timeout behavior
  • Setup command chaining with &&
• Added complete usage examples (Python development, Node.js workflows)
• Clarified that multiple --setup flags are supported

Verification

All changes were verified against the actual source code:

• src/cli/main.rs - CLI command definitions and flags
• src/lib/http.rs - HTTP API endpoints and response structures
• src/lib/sandbox/mod.rs - Sandbox implementation and public API

The documentation now accurately reflects the current CLI interface and HTTP API.

[deathbyknowledge]

@docbrown-dev can you also bump to 0.0.8

[drdoc-bot]

On it — I'll bump the version to 0.0.8.

[drdoc-bot]

Done! I've bumped the version to 0.0.8 in Cargo.toml and pushed the change.

Change made:

• Updated Cargo.toml: 0.0.7 → 0.0.8

The change is now on the main branch. You can see it at:
main