@roarkanalytics/cli 0.29.0 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.32.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.31.1...v0.32.0) (2026-09-29)
+
+
+### Features
+
+* **cli:** cli update ([#79](https://github.com/roarkhq/cli-roark-analytics/issues/79)) ([9147caa](https://github.com/roarkhq/cli-roark-analytics/commit/9147caab0016324dd5307014257ca497e32aaaac))
+
+## [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

@@ -230,6 +230,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 +278,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',
@@ -1795,7 +1796,7 @@ exports.COMMANDS = [
         httpMethod: 'post',
         httpPath: '/v1/config/apply',
         summary: 'Apply a config bundle',
-        description: 'Reconcile a config-as-code bundle into the project. Submit the full desired set of resources; resources already managed by config are updated, new ones created, and (unless prune is false) config-managed resources absent from the bundle are deleted. Identity is by name — no ids in the bundle.',
+        description: 'Reconcile a config-as-code bundle. With a PROJECT API key, submit project-scoped resources (agents, personas, flows, collectors, metrics, ...). With an ORGANIZATION API key, submit `kind: project` resources, each optionally carrying its members and its own nested `resources`. Submit the full desired set; managed resources are updated, new ones created, and (unless prune is false) managed resources absent from the bundle are deleted. Identity is by name.',
         positionals: [],
         flags: [
             {
@@ -1829,7 +1830,7 @@ exports.COMMANDS = [
         httpMethod: 'post',
         httpPath: '/v1/config/diff',
         summary: 'Diff a config bundle',
-        description: 'Dry run for a config-as-code apply: returns the projected changes (create / update / delete) for the submitted bundle without writing anything. Submit the full desired set of resources; identity is by name — no ids in the bundle. Run this before apply to preview what would change.',
+        description: 'Dry run for an apply: returns the projected changes (create / update / delete) for the submitted bundle without writing anything. Works for both project and organization keys.',
         positionals: [],
         flags: [
             {
@@ -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,
+    },
 ];