@easysociable/cli 0.1.36 → 0.1.37

package/README.md

@@ -120,12 +120,30 @@ re-read on each tool call, so no host restart is needed after login
 
 ```bash
 easysociable auth login            # opens the browser; approve and the key is stored automatically
-easysociable auth login --api-key <key> --gateway-url https://gateway.easysociable.com   # headless / CI
+easysociable auth login --api-key <key>   # headless / CI
 easysociable auth status
 easysociable templates list --json
 easysociable mcp serve --transport stdio
 ```
 
+The gateway resolves in this order: `EASYSOCIABLE_GATEWAY_URL` (or legacy `EASYSOCIABLE_API_URL`)
+env → the `baseUrl` stored by `auth login` → the build default. The npm package is a production
+build (`https://gateway.easysociable.com`, site `https://easysociable.com`) and never uses a local
+gateway unless you export `EASYSOCIABLE_GATEWAY_URL` for that shell: it ignores a stored
+`127.0.0.1` / `localhost` `baseUrl` (e.g. `http://127.0.0.1:8787` written by CLI ≤ 0.1.36, which
+recovers without re-login) and refuses `auth login --gateway-url http://127.0.0.1:…`.
+
+### Building: production vs development
+
+Environment defaults are baked at build time from `build-envs.mjs`; a bundle carries exactly one profile.
+
+```bash
+pnpm --filter @easysociable/cli build       # production (what prepack/npm publish ships)
+pnpm --filter @easysociable/cli build:dev   # development: gateway 127.0.0.1:8787, site 127.0.0.1:5175
+pnpm --filter @easysociable/cli dev         # development, watch mode
+pnpm --filter @easysociable/cli check:dist  # fails unless dist is a production build (runs in prepack)
+```
+
 ## Other commands
 
 | Command | Purpose |