@roarkanalytics/cli 0.29.0 → 0.31.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # 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)
 
 

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',
@@ -3562,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',
@@ -5787,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,
+    },
 ];