@wordbricks/velen 0.1.2-win32-x64 → 0.1.3-darwin-arm64

package/README.md

@@ -7,6 +7,28 @@ Key references:
 - Human-oriented protocol and workflow spec: `docs/SPEC.md`
 - Generated JSON API contract: `openapi/cli.openapi.json`
 
+Runtime config:
+
+- On Unix-like systems, the user config file is `${XDG_CONFIG_HOME:-~/.config}/velen/config.toml`.
+- On Windows, the user config file is `%APPDATA%\\velen\\config.toml`.
+- The current persisted keys are `active_org` and `request_timeout_sec`.
+- 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.
+- `velen auth logout` clears both the stored auth session and the stored `active_org`, so later org-scoped commands fail explicitly until a new org is selected.
+
+Credential storage:
+
+- On Unix-like systems, the CLI persists the full auth session blob to `${XDG_CONFIG_HOME:-~/.config}/velen/auth.json`.
+- On Windows, the CLI persists the full auth session blob to `%APPDATA%\\velen\\auth.json`.
+- `auth.json` stores the user identity, bearer token, session timing metadata, and the last refresh timestamp.
+- Authenticated commands now run an explicit auth-session lifecycle before building an authenticated API client:
+  load `auth.json` on startup -> call the CLI session refresh contract -> persist the returned token and timing metadata.
+
+Version cache:
+
+- Release builds refresh `${XDG_CONFIG_HOME:-~/.config}/velen/version.json` on Unix-like systems and `%APPDATA%\\velen\\version.json` on Windows as a cached latest-version record sourced from the npm dist-tags for `@wordbricks/velen`.
+- The cache format mirrors Codex: `latest_version`, `last_checked_at`, and `dismissed_version`.
+
 Install:
 
 - `bun install -g @wordbricks/velen`

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@wordbricks/velen",
-  "version": "0.1.2-win32-x64",
+  "version": "0.1.3-darwin-arm64",
   "description": "Velen CLI",
   "license": "Apache-2.0",
   "os": [
-    "win32"
+    "darwin"
   ],
   "cpu": [
-    "x64"
+    "arm64"
   ],
   "files": [
     "vendor",