googleworkspace · jpoehnelt · Mar 13, 2026 · Mar 13, 2026
diff --git a/.changeset/add-structured-logging.md b/.changeset/add-structured-logging.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # @googleworkspace/cli
 
+## 0.15.0
+
+### Minor Changes
+
+- 6f3e090: Add opt-in structured HTTP request logging via `tracing`
+
+  New environment variables:
+
+  - `GOOGLE_WORKSPACE_CLI_LOG`: stderr log filter (e.g., `gws=debug`)
+  - `GOOGLE_WORKSPACE_CLI_LOG_FILE`: directory for JSON log files with daily rotation
+
+  Logging is completely silent by default (zero overhead). Only PII-free metadata is logged: API method ID, HTTP method, status code, latency, and content-type.
+
 ## 0.14.0
 
 ### Minor 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.14.0"
+version = "0.15.0"
 edition = "2021"
 description = "Google Workspace CLI — dynamic command surface from Discovery Service"
 license = "Apache-2.0"

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