@seldonqa/cli 0.12.0 → 0.13.0

package/README.md

@@ -118,9 +118,7 @@ If your account has too many tunnels open at once you'll get `Tunnel limit reach
 
 **One local target, one run at a time.** Runs against the same local URL in the same workspace share a single tunnel. That includes two terminals, a terminal and a CI job, or two teammates. Whichever run finishes first closes the tunnel, and the other run loses access to your app. Until this is fixed, run them one after another.
 
-## Usability studies (preview)
-
-> Preview: running a study needs a Seldon backend with usability runs enabled. Authoring and `validate` work offline today.
+## Usability studies
 
 Alongside QA, a project can keep **usability studies** as code: personas from your workspace attempt a goal on your app, and you get back a summary of where they struggled. Each study is one committed `<name>.usability.yml` file at the project root, next to `seldon.yml`. Every key is required except `version` and `credentials`:
 
@@ -153,6 +151,7 @@ seldon init --type usability trial-signup --dir studies   # …or into another d
 seldon validate --file trial-signup.usability.yml
 seldon run --file trial-signup.usability.yml          # waits, then prints a short report (--md / --full / --json)
 seldon report                                         # re-show the last run's report
+seldon personas                                       # the persona names your workspace has (--limit / --offset to page)
 ```
 
 - **Which kind of file?** A file named `*.usability.yml` is always a usability study, so a study with a YAML error or a misspelled key gets usability errors rather than QA ones. Otherwise the CLI decides from the content: a top-level `experiment:` block is a usability study, `testCases:` is a QA suite. Pass `--type usability` (or `--type qa`) to `run` / `validate` to make that explicit; a contradicting `--type` is an error.
@@ -193,17 +192,18 @@ seldon report                                         # re-show the last run's r
 | Command | What it does |
 | --- | --- |
 | `seldon init` | Scaffold a template `seldon.yml` |
-| `seldon init --type usability [name] [--dir <dir>]` | Scaffold a `<name>.usability.yml` study (preview) |
+| `seldon init --type usability [name] [--dir <dir>]` | Scaffold a `<name>.usability.yml` study |
 | `seldon cases add` | Append a test case (`--name` `--step …` `--criteria`) |
 | `seldon cases` | List the cases in the current `seldon.yml` |
 | `seldon validate [--file <file>] [--type qa\|usability]` | Validate `seldon.yml` (or any QA suite / usability study) locally |
-| `seldon run --file <name>.usability.yml` | Run a usability study and print a short report with a link to the app (preview) |
+| `seldon run --file <name>.usability.yml` | Run a usability study and print a short report with a link to the app |
 | `seldon run [--url <url>]` | Ingest `seldon.yml` and run it; a local `--url` is auto-exposed via a Cloudflare tunnel (`--auto-approve` to skip the prompt); `--no-wait` to detach, `--fail-on` to gate, `--label <tag>` to profile |
 | `seldon report [--md \| --json] [--full]` | Show the report for the last run (or `--id <run>`); for a usability run, a short report with a link to the app (`--md` / `--full` for the Markdown summary) |
 | `seldon logs --follow` | Stream the agent's live reasoning |
 | `seldon runs` | List QA runs with color-coded status |
 | `seldon cancel --id <run>` | Stop a run mid-flight |
 | `seldon list` | List baselines your key can see |
+| `seldon personas [--limit <n>] [--offset <n>]` | List the personas your key can see (name and description, 10 at a time), for a study's `personas:` list |
 | `seldon config` · `login` | Manage credentials and settings |
 | `seldon api <operation>` | Call any Blok API operation directly |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seldonqa/cli",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Seldon QA - generate a QA test plan from any codebase and run AI agents against your live app, from your terminal or CI.",
   "type": "module",
   "keywords": [
@@ -32,11 +32,11 @@
     "commander": "^12.1.0"
   },
   "optionalDependencies": {
-    "@seldonqa/cli-darwin-x64": "0.12.0",
-    "@seldonqa/cli-darwin-arm64": "0.12.0",
-    "@seldonqa/cli-linux-arm64": "0.12.0",
-    "@seldonqa/cli-win32-x64": "0.12.0",
-    "@seldonqa/cli-linux-x64": "0.12.0"
+    "@seldonqa/cli-darwin-arm64": "0.13.0",
+    "@seldonqa/cli-darwin-x64": "0.13.0",
+    "@seldonqa/cli-win32-x64": "0.13.0",
+    "@seldonqa/cli-linux-x64": "0.13.0",
+    "@seldonqa/cli-linux-arm64": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",