feat: migrate to hey-api SDK, upgrade prompt UX, code fixes

- Replace hand-written API client with hey-api generated SDK (client-fetch + byTags)
- Add response interceptor for RFC 7807 error parsing
- Use hey-api auth config for token injection
- Upgrade org selection from readline to @inquirer/select
- Extract resolveExpiry, fix formatter UsageError, add chmod to config
- Rewrite README for v1
- Add biome overrides for generated files and test any

Author: grayashh

README.md

@@ -16,53 +16,85 @@ npx @talkvalue/cli --help
 
 ## Requirements
 
-- Node.js >= 22
+- Node.js >= 24
 
 ## Authentication
 
 ```bash
-talkvalue auth login
+talkvalue auth login              # device code flow + org selection
+talkvalue auth login --org "Acme" # skip interactive org selection
 ```
 
-The CLI prints a one-time code and opens a verification URL in your browser. Complete the login to authenticate.
+The CLI prints a one-time code and opens a verification URL in your browser. After login, select an organization to scope your session.
+
+### Managing sessions
 
 ```bash
-talkvalue auth status          # check current session
-talkvalue auth logout          # clear session
-talkvalue auth switch <profile> # switch org profile
+talkvalue auth status             # current session info
+talkvalue auth switch [org]       # switch organization (interactive or by name/id)
+talkvalue auth list               # list all profiles
+talkvalue auth logout             # clear session
 ```
 
-For CI/CD, set `TALKVALUE_TOKEN` to skip interactive login:
+### CI/CD
+
+Set `TALKVALUE_TOKEN` to skip interactive login:
 
 ```bash
 TALKVALUE_TOKEN="eyJ..." talkvalue path person list
 ```
 
-## Common Commands
+## Commands
 
 ```bash
+# Overview
 talkvalue path overview                       # dashboard summary
+
+# People
 talkvalue path person list --page-size 20     # list people
 talkvalue path person get <id>                # person details
+talkvalue path person update <id> --name "…"  # update person
+talkvalue path person delete <id>             # delete person
+talkvalue path person export                  # CSV export
+
+# Channels
 talkvalue path channel list                   # list channels
 talkvalue path channel create --name "VIP"    # create channel
-talkvalue path person export                  # CSV export
+talkvalue path channel update <id> --name "…" # update channel
+talkvalue path channel delete <id>            # delete channel
+
+# Config
 talkvalue config list                         # show config
+talkvalue config get <key>                    # get value
+talkvalue config set <key> <value>            # set value
+
+# Version
 talkvalue version                             # version info
 ```
 
 ## Global Flags
 
 ```
 --format <json|table|csv>   output format (default: table for TTY, json for pipe)
---profile <name>            use specific org profile
+--profile <name>            use specific profile
+--api-url <url>             API base URL override
 --no-color                  disable colored output
--q, --quiet                 suppress non-essential output
--v, --verbose               enable verbose logging
 --page <n>                  page number
 --page-size <n>             page size
 ```
 
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `TALKVALUE_TOKEN` | Bearer token (skips interactive auth) |
+| `TALKVALUE_API_URL` | API base URL override |
+| `TALKVALUE_AUTH_API_URL` | Auth API base URL override |
+| `TALKVALUE_PROFILE` | Active profile override |
+| `NO_COLOR` | Disable colored output |
+| `FORCE_COLOR` | Force colored output |
+| `XDG_CONFIG_HOME` | Config directory base (default: `~/.config`) |
+
 ## Output Contract
 
 Machine-readable output is intentionally lean.
@@ -96,7 +128,7 @@ Exit codes: `0` success, `1` error, `2` usage, `3` auth, `4` not-found, `5` forb
 
 ## Configuration
 
-Config is stored at `~/.talkvalue/config.yml` (or `$XDG_CONFIG_HOME/talkvalue/`).
+Config is stored at `~/.talkvalue/config.yml` (or `$XDG_CONFIG_HOME/talkvalue/`). File permissions are `0o600` (owner-only).
 
 ```bash
 talkvalue config list

biome.json

@@ -14,6 +14,7 @@
         "noDefaultExport": {
           "level": "off"
         },
+        "noNonNullAssertion": "warn",
         "useImportType": "error"
       },
       "suspicious": {
@@ -35,6 +36,18 @@
     }
   },
   "files": {
-    "ignore": ["node_modules", "dist", "coverage", "*.json"]
-  }
+    "ignore": ["node_modules", "dist", "coverage", "*.json", "src/api/generated"]
+  },
+  "overrides": [
+    {
+      "include": ["test/**"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ]
 }

package.json

@@ -52,6 +52,7 @@
     ]
   },
   "dependencies": {
+    "@inquirer/select": "^5.1.2",
     "@napi-rs/keyring": "^1.2.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",