Three additions to reduce onboarding friction:
1. docs/AGENT-PAIRING.md — step-by-step guide designed for AI agent
ingestion. Covers the full Workspace↔Gateway pairing flow from
scratch: hermes-agent install → env var setup → API server enable →
port verification → workspace .env → startup verification. Includes
platform-specific notes (WSL, macOS, Linux), a copy-paste quick-fix
block, and a diagnostic bundle command for when things go wrong.
2. docs/troubleshooting.md — human-readable FAQ covering the six most
common setup failures (API server not binding, mode=disconnected,
port conflicts, WSL cold-start race, dev server crashes, onboarding
error state). Each entry has cause → fix → verify.
3. install.sh — added a post-setup guard that scans ~/.hermes/.env for
env var names missing underscores (APISERVERENABLED vs
API_SERVER_ENABLED). The gateway reads exact names via os.getenv()
and silently ignores typos — this produces a 'gateway starts but API
server never binds' failure that's hard to diagnose from the UI.
The guard now warns the user with the correct names.
