@wordbricks/velen 0.2.26-darwin-arm64 → 0.2.27-darwin-arm64

package/README.md

@@ -15,9 +15,16 @@ Runtime config:
 - Named profiles use `${XDG_CONFIG_HOME:-~/.config}/velen/profiles/<profile>/config.toml` on Unix-like systems and `%APPDATA%\\velen\\profiles\\<profile>\\config.toml` on Windows.
 - Select a profile with `--profile <profile>`, `VELEN_PROFILE`, or the persisted default from `velen profile switch <profile>`; `--profile` takes precedence over `VELEN_PROFILE`, which takes precedence over the persisted default. The default profile keeps using the legacy flat paths above.
 - List local profiles with `velen profile list`.
-- The current persisted keys are `active_org` and `request_timeout_sec`.
+- The current persisted keys are `active_org` and `request_timeout_sec`; the
+  built-in request timeout defaults to 180 seconds.
 - Runtime config is resolved in this order: built-in defaults -> user config file -> internal typed runtime overrides.
 - `velen org use <org>` persists `active_org`. Passing `--org <org>` for a command takes precedence over the stored `active_org` value for that invocation.
+- The CLI generates an invocation-scoped request ID when `--request-id` is not
+  provided, attaches it to outbound HTTP requests, and can report it on
+  transport errors even when no response body is received.
+- Prefer the built-in request timeout for normal commands. Use `--timeout <sec>`
+  only when an invocation intentionally needs a shorter or longer request
+  window.
 - `velen auth logout` clears both the stored auth session and the stored `active_org` for the selected profile, so later org-scoped commands fail explicitly until a new org is selected.
 
 Credential storage:

package/package.json

@@ -20,7 +20,7 @@
     "url": "git+https://github.com/wordbricks/velen.git",
     "directory": "apps/cli"
   },
-  "version": "0.2.26-darwin-arm64",
+  "version": "0.2.27-darwin-arm64",
   "engines": {
     "node": ">=18"
   }