Constant USAGE 

pub const USAGE: &str = "Usage:
  soma [-y|--yes] <command> [options]
  soma mcp              Start MCP stdio transport
  soma serve            Start HTTP MCP + REST + Web server

  soma greet [--name NAME]       Greet NAME (or the world)
  soma echo --message MSG        Echo MSG back
  soma status                    Show server status
  soma help                      Show JSON action reference
  soma doctor [--json]           Run environment pre-flight checks
  soma watch [--url URL] [--interval N]  Poll /health and emit on state change
  soma self-update run --version V --url URL --sha256 HEX
                       [--state-file PATH] [--allow-http-loopback]
                                 Download, validate, and install a new binary
  soma self-update recover [--state-file PATH]  Reconcile pending update state
  soma self-update confirm [--state-file PATH]  Confirm update after healthy restart
  soma setup check               Check plugin setup without mutating appdata
  soma setup repair              Create missing appdata/env setup files
  soma setup plugin-hook [--no-repair]  Plugin hook JSON contract
  soma providers validate        Validate provider manifests and compiled schemas
  soma providers inspect         Show provider manifests, surfaces, and capability posture
  soma providers test ACTION [--json JSON]  Dispatch one provider action through the registry
  soma providers list [--dir DIR] [--json]    List drop-in provider files (no execution)
  soma providers lint [--dir DIR] [--json]    Lint drop-in provider files (no execution)
  soma providers status [--dir DIR] [--json]  Summarize drop-in provider files (no execution)
  soma providers graduate --source FILE --workspace DIR [--fixtures FILE]
  soma providers build-component --workspace DIR [--component FILE]
  soma providers verify-component --component FILE
  soma providers compare --component FILE --fixtures FILE
  soma providers activate --workspace DIR
  soma providers rollback --workspace DIR
  soma package generate [--write|--check]  Refresh generated provider docs, skills, and plugin metadata

Global options:
  -y, --yes                    Confirm destructive local operator actions without prompting

  soma --help                    Show this help
  soma --version                 Show version

Environment:
  SOMA_API_URL          Deployed platform API or upstream service URL
  SOMA_API_KEY          Bearer token or upstream service API key
  SOMA_MCP_HOST         HTTP server bind host (default 127.0.0.1)
  SOMA_MCP_PORT         HTTP server bind port (default 40060)
  SOMA_MCP_NO_AUTH      Disable auth (loopback only)
  SOMA_MCP_TOKEN        Static bearer token
  RUST_LOG                 Log filter (e.g. info,rmcp=warn)";