@roarkanalytics/cli 0.28.0 → 0.31.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.31.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.31.0...v0.31.1) (2026-09-29)
+
+
+### Bug Fixes
+
+* **deps:** require the SDK release that has the `project` option ([#77](https://github.com/roarkhq/cli-roark-analytics/issues/77)) ([04a2553](https://github.com/roarkhq/cli-roark-analytics/commit/04a255329242ab8abdc95acb77b26a6fcd7fff4d))
+
+## [0.31.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.30.0...v0.31.0) (2026-09-29)
+
+
+### Features
+
+* **project:** choose the project a command acts on ([#61](https://github.com/roarkhq/cli-roark-analytics/issues/61)) ([240b672](https://github.com/roarkhq/cli-roark-analytics/commit/240b67220696ca58c36f15e8c846cdffc396b293))
+
+## [0.30.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.29.0...v0.30.0) (2026-09-28)
+
+
+### Features
+
+* **cli:** cli update ([#74](https://github.com/roarkhq/cli-roark-analytics/issues/74)) ([2fd7ff5](https://github.com/roarkhq/cli-roark-analytics/commit/2fd7ff54f2dbfe0a47d933a96edd1cdc7d176d60))
+
+## [0.29.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.28.0...v0.29.0) (2026-09-28)
+
+
+### Features
+
+* **cli:** cli update ([#72](https://github.com/roarkhq/cli-roark-analytics/issues/72)) ([1ecc3a1](https://github.com/roarkhq/cli-roark-analytics/commit/1ecc3a1162173d6d6ac974e8c8acc89945f7d6ce))
+
 ## [0.28.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.27.0...v0.28.0) (2026-09-24)
 
 

package/README.md

@@ -40,6 +40,28 @@ a stored or environment credential to it. Pass `--allow-project-base-url` (or se
 `ROARK_ALLOW_PROJECT_BASE_URL`) once you have read the file, or `--token` to send a
 different credential.
 
+## Choose a project
+
+`auth login` gives you a credential that acts as you, and it can reach every project
+you belong to. So commands need to know which project they act on. The login writes
+the project you picked on the consent screen, and after that there is nothing to do:
+
+```sh
+roark config set project <project-id>   # change it
+roark config get project                # see it
+roark agent list --project <id>         # just this once
+export ROARK_PROJECT_ID="..."           # or for a shell
+```
+
+Precedence is the usual one: `--project`, then `ROARK_PROJECT_ID`, then `.roark.json`,
+then the user config. Committing `{"project": "..."}` in a repository's `.roark.json`
+is the intended way to pin a checkout to one project, and unlike `baseURL` it needs no
+opt-in: a project id chooses which of your own projects you act on, it cannot send your
+credential anywhere new.
+
+If you authenticate with a **project API key** instead, the key already names its
+project and all of this is ignored.
+
 ## Usage
 
 Commands read noun before verb, and the verb is one of `list`, `get`, `create`,
@@ -230,6 +252,12 @@ roark completion fish | source
 | `roark metric variant list <id-or-slug>`                                         | List a metric’s variants               |
 | `roark metric variant update <id-or-slug> <variant-id>`                          | Update a metric variant                |
 
+### project
+
+| Command              | Description                                |
+| -------------------- | ------------------------------------------ |
+| `roark project list` | List projects available to this credential |
+
 ### simulation
 
 | Command                                                                                                                                                 | Description                         |
@@ -272,6 +300,12 @@ roark completion fish | source
 | `roark webhook get <webhook-id>`                      | Get webhook by ID |
 | `roark webhook list`                                  | List webhooks     |
 
+### whoami
+
+| Command        | Description                     |
+| -------------- | ------------------------------- |
+| `roark whoami` | Describe the current credential |
+
 ## Requirements
 
 Node.js 20 or newer.

package/commands.js

@@ -40,6 +40,7 @@ exports.GROUPS = {
     'metric definition': 'Manage metric definitions',
     'metric policy': 'Manage metric policies',
     'metric variant': 'Manage metric variants',
+    project: 'Read projects',
     simulation: 'Manage simulations',
     'simulation environment': 'Manage simulation environments',
     'simulation job': 'Read simulation jobs',
@@ -2000,6 +2001,15 @@ exports.COMMANDS = [
                 valueKind: 'string',
                 repeatable: false,
             },
+            {
+                name: 'additional-expectations',
+                path: ['additionalExpectations'],
+                location: 'body',
+                required: false,
+                description: "The expectations graded on this variant only, on top of the flow's own. Sent as the complete set: it replaces whatever the variant had, so omit it to leave the set alone and send [] to clear it. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on every graph edit.",
+                valueKind: 'array',
+                repeatable: false,
+            },
             {
                 name: 'persona-override-id',
                 path: ['personaOverrideId'],
@@ -2142,7 +2152,7 @@ exports.COMMANDS = [
                 path: ['additionalExpectations'],
                 location: 'body',
                 required: false,
-                description: "Replaces the expectations that apply to this variant on top of the flow's. Omit to leave them alone, send [] to clear. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on the next graph edit.",
+                description: "The expectations graded on this variant only, on top of the flow's own. Sent as the complete set: it replaces whatever the variant had, so omit it to leave the set alone and send [] to clear it. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on every graph edit.",
                 valueKind: 'array',
                 repeatable: false,
             },
@@ -2286,7 +2296,7 @@ exports.COMMANDS = [
                 path: ['additionalExpectations'],
                 location: 'body',
                 required: false,
-                description: "Replaces the expectations that apply to this variant on top of the flow's. Omit to leave them alone, send [] to clear. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on the next graph edit.",
+                description: "The expectations graded on this variant only, on top of the flow's own. Sent as the complete set: it replaces whatever the variant had, so omit it to leave the set alone and send [] to clear it. Improv flows only: a scripted variant's expectations come from the agent turns on its path and are rewritten on every graph edit.",
                 valueKind: 'array',
                 repeatable: false,
             },
@@ -3553,6 +3563,23 @@ exports.COMMANDS = [
         acceptsBody: true,
         requiresAuth: true,
     },
+    {
+        commandPath: ['project', 'list'],
+        clientProperty: 'project',
+        methodName: 'list',
+        httpMethod: 'get',
+        httpPath: '/v1/projects',
+        summary: 'List projects available to this credential',
+        description: 'Returns every project the calling credential may act on, with the permissions it holds in each. A project-scoped API key returns the single project it is bound to. A user-scoped credential returns the projects in its organization where the holder is an active member. Use the returned id in the X-Roark-Project-Id header.',
+        positionals: [],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
     {
         commandPath: ['simulation', 'environment', 'create'],
         clientProperty: 'simulationEnvironment',
@@ -5778,4 +5805,21 @@ exports.COMMANDS = [
         acceptsBody: false,
         requiresAuth: true,
     },
+    {
+        commandPath: ['whoami'],
+        clientProperty: 'me',
+        methodName: 'get',
+        httpMethod: 'get',
+        httpPath: '/v1/me',
+        summary: 'Describe the current credential',
+        description: 'Returns the scope of the credential making the request, the organization it acts in, its default project (if any) and the permissions it was granted. Works for both project-scoped API keys and user-scoped credentials from the CLI or an MCP connector.',
+        positionals: [],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
 ];