googleworkspace · jpoehnelt · Mar 23, 2026 · Mar 23, 2026 · Mar 23, 2026
diff --git a/.changeset/add-dry-run-to-event-helpers.md b/.changeset/add-dry-run-to-event-helpers.md
diff --git a/.changeset/fix-mask-secret-utf8-panic.md b/.changeset/fix-mask-secret-utf8-panic.md
diff --git a/.changeset/fix-setup-help-flag.md b/.changeset/fix-setup-help-flag.md
diff --git a/.changeset/fix-skill-frontmatter-flow-sequences.md b/.changeset/fix-skill-frontmatter-flow-sequences.md
diff --git a/.changeset/fix-token-dir-error-propagation.md b/.changeset/fix-token-dir-error-propagation.md
diff --git a/.changeset/refactor-auth-clap.md b/.changeset/refactor-auth-clap.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,37 @@
 # @googleworkspace/cli
 
+## 0.19.0
+
+### Minor Changes
+
+- a078945: Refactor all `gws auth` subcommands to use clap for argument parsing
+
+  Replace manual argument parsing in `handle_auth_command`, `handle_login`, `resolve_scopes`, and `handle_export` with structured `clap::Command` definitions. Introduces `ScopeMode` enum for type-safe scope selection and adds proper `--help` support for all auth subcommands.
+
+### Patch Changes
+
+- 8a749c2: feat(helpers): add --dry-run support to events helper commands
+
+  Add dry-run mode to `gws events +renew` and `gws events +subscribe` commands.
+  When --dry-run is specified, the commands will print what actions would be
+  taken without making any API calls. This allows agents to simulate requests
+  and learn without reaching the server.
+
+- d679401: Fix `mask_secret` panic on multi-byte UTF-8 secrets by using char-based indexing instead of byte-offset slicing
+- d341de2: Handle --help/-h in `gws auth setup` before launching the setup wizard, preventing accidental project creation when users just want usage info
+- f157208: fix: use block-style YAML sequences in generated SKILL.md frontmatter
+
+  Replace flow sequences (`bins: ["gws"]`, `skills: [...]`) with block-style
+  sequences (`bins:\n  - gws`) in all generated SKILL.md frontmatter templates.
+
+  Flow sequences are valid YAML but rejected by `strictyaml`, which the
+  Agent Skills reference implementation (`agentskills validate`) uses to parse
+  frontmatter. This caused all 93 generated skills to fail validation.
+
+  Fixes #521
+
+- b4d5e26: Fix auth error propagation: properly propagate errors when token directory creation or permission setting fails, instead of silently ignoring them
+
 ## 0.18.1
 
 ### Patch Changes

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -14,7 +14,7 @@
 
 [package]
 name = "gws"
-version = "0.18.1"
+version = "0.19.0"
 edition = "2021"
 description = "Google Workspace CLI — dynamic command surface from Discovery Service"
 license = "Apache-2.0"

diff --git a/flake.lock b/flake.lock
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@googleworkspace/cli",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "private": true,
   "description": "Google Workspace CLI — dynamic command surface from Discovery Service",
   "license": "Apache-2.0",

diff --git a/skills/gws-admin-reports/SKILL.md b/skills/gws-admin-reports/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws admin-reports --help"
 ---
 

diff --git a/skills/gws-calendar-agenda/SKILL.md b/skills/gws-calendar-agenda/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws calendar +agenda --help"
 ---
 

diff --git a/skills/gws-calendar-insert/SKILL.md b/skills/gws-calendar-insert/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws calendar +insert --help"
 ---
 

diff --git a/skills/gws-calendar/SKILL.md b/skills/gws-calendar/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws calendar --help"
 ---
 

diff --git a/skills/gws-chat-send/SKILL.md b/skills/gws-chat-send/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws chat +send --help"
 ---
 

diff --git a/skills/gws-chat/SKILL.md b/skills/gws-chat/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws chat --help"
 ---
 

diff --git a/skills/gws-classroom/SKILL.md b/skills/gws-classroom/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws classroom --help"
 ---
 

diff --git a/skills/gws-docs-write/SKILL.md b/skills/gws-docs-write/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws docs +write --help"
 ---
 

diff --git a/skills/gws-docs/SKILL.md b/skills/gws-docs/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws docs --help"
 ---
 

diff --git a/skills/gws-drive-upload/SKILL.md b/skills/gws-drive-upload/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws drive +upload --help"
 ---
 

diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws drive --help"
 ---
 

diff --git a/skills/gws-events-renew/SKILL.md b/skills/gws-events-renew/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws events +renew --help"
 ---
 

diff --git a/skills/gws-events-subscribe/SKILL.md b/skills/gws-events-subscribe/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws events +subscribe --help"
 ---
 

diff --git a/skills/gws-events/SKILL.md b/skills/gws-events/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws events --help"
 ---
 

diff --git a/skills/gws-forms/SKILL.md b/skills/gws-forms/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws forms --help"
 ---
 

diff --git a/skills/gws-gmail-forward/SKILL.md b/skills/gws-gmail-forward/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +forward --help"
 ---
 

diff --git a/skills/gws-gmail-read/SKILL.md b/skills/gws-gmail-read/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +read --help"
 ---
 

diff --git a/skills/gws-gmail-reply-all/SKILL.md b/skills/gws-gmail-reply-all/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +reply-all --help"
 ---
 

diff --git a/skills/gws-gmail-reply/SKILL.md b/skills/gws-gmail-reply/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +reply --help"
 ---
 

diff --git a/skills/gws-gmail-send/SKILL.md b/skills/gws-gmail-send/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +send --help"
 ---
 

diff --git a/skills/gws-gmail-triage/SKILL.md b/skills/gws-gmail-triage/SKILL.md
@@ -6,7 +6,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - gws
     cliHelp: "gws gmail +triage --help"
 ---