gws-workspacelisted

# gws Workspace Operations Operate a user's Google Workspace account through the `gws` CLI — one binary covering every Workspace API, built dynamically from Google's Discovery Service, with structured JSON output. It is open source (Apache-2.0) but **not an officially supported Google product** and is pre-v1: expect breaking changes and pin versions in production. ## Preflight Before the first gws call in a session: ```bash gws auth status --format json ``` - `auth_method: "oauth2"` or `service_account` → proceed. - `auth_method: "none"` → stop. Follow `references/setup-guide.md` with the user to install gws and complete OAuth. Never invent client IDs, client secrets, or tokens; OAuth setup requires real user actions in the Google Cloud Console. - `command not found` → install: `npm install -g @googleworkspace/cli` (alternatives: `brew install googleworkspace-cli`, cargo, nix). The stderr line `Using keyring backend: keyring` is informational, not an error. Parse stdout only. ## Command Model Two surfaces; prefer helper commands when one fits. **Helper commands (`+` prefix, hand-written):** | Service | Command | Purpose | | --- | --- | --- | | gmail | `+send --to A --subject S --body B` | Send email | | gmail | `+reply --message-id ID --body B` | Reply (threads automatically) | | gmail | `+triage` | Unread inbox summary | | gmail | `+watch` | Stream new mail as NDJSON | | calendar | `+agenda [--today] [--timezone TZ]` | Upcoming events | | calendar | `+inser