@roarkanalytics/cli 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.23.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.22.0...v0.23.0) (2026-09-21)
+
+
+### ⚠ BREAKING CHANGES
+
+* **cli:** removes or renames commands. Scripts using the old names will fail.
+
+### Features
+
+* **cli:** cli update ([#54](https://github.com/roarkhq/cli-roark-analytics/issues/54)) ([2722903](https://github.com/roarkhq/cli-roark-analytics/commit/2722903aae2a0bb35dd6060fb11a6957c7a92f83))
+
 ## [0.22.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.21.0...v0.22.0) (2026-09-18)
 
 

package/README.md

@@ -126,14 +126,14 @@ roark completion fish | source
 
 | Command                                                                                                              | Description                          |
 | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
-| `roark autoimprove fix answer <fix-id> --text <value>`                                                               | Answer Roark's question              |
-| `roark autoimprove fix cancel <fix-id>`                                                                              | Cancel a fix                         |
-| `roark autoimprove fix create --agent-id <value> --objective-metric-definition-id <value> --objective-label <value>` | Start an Autoimprove fix             |
-| `roark autoimprove fix dismiss <fix-id>`                                                                             | Dismiss a verified fix               |
-| `roark autoimprove fix get <fix-id>`                                                                                 | Get an Autoimprove fix               |
-| `roark autoimprove fix guidance send <fix-id> --text <value>`                                                        | Send guidance to a running fix       |
-| `roark autoimprove fix list`                                                                                         | List Autoimprove fixes               |
-| `roark autoimprove fix promote <fix-id>`                                                                             | Promote a verified fix to production |
+| `roark autoimprove job answer <job-id> --text <value>`                                                               | Answer Roark's question              |
+| `roark autoimprove job cancel <job-id>`                                                                              | Cancel a job                         |
+| `roark autoimprove job create --agent-id <value> --objective-metric-definition-id <value> --objective-label <value>` | Start an Autoimprove job             |
+| `roark autoimprove job dismiss <job-id>`                                                                             | Dismiss a verified job               |
+| `roark autoimprove job get <job-id>`                                                                                 | Get an Autoimprove job               |
+| `roark autoimprove job guidance send <job-id> --text <value>`                                                        | Send guidance to a running job       |
+| `roark autoimprove job list`                                                                                         | List Autoimprove jobs                |
+| `roark autoimprove job promote <job-id>`                                                                             | Promote a verified job to production |
 
 ### benchmark
 

package/commands.js

@@ -13,8 +13,8 @@ exports.GROUPS = {
     'agent prompt': 'Manage agent prompts',
     'agent prompt version': 'Read agent prompt versions',
     autoimprove: 'Manage autoimproves',
-    'autoimprove fix': 'Manage autoimprove fixes',
-    'autoimprove fix guidance': 'Read autoimprove fix guidance',
+    'autoimprove job': 'Manage autoimprove jobs',
+    'autoimprove job guidance': 'Read autoimprove job guidance',
     benchmark: 'Read benchmarks',
     'benchmark leaderboard': 'Read benchmark leaderboard',
     'benchmark metric': 'Read benchmark metrics',
@@ -484,17 +484,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'answer'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'answer'],
+        clientProperty: 'autoimproveJob',
         methodName: 'answerQuestion',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix/{fixId}/answer',
+        httpPath: '/v1/autoimprove/job/{jobId}/answer',
         summary: "Answer Roark's question",
-        description: 'Answer the question a fix is blocked on. Only meaningful while the fix status is NEEDS_INPUT (the open QUESTION entry carries the offered options; free text is also accepted). Otherwise returns a conflict.',
+        description: 'Answer the question a job is blocked on. Only meaningful while the job status is NEEDS_INPUT (the open QUESTION entry carries the offered options; free text is also accepted). Otherwise returns a conflict.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [
@@ -516,17 +516,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'cancel'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'cancel'],
+        clientProperty: 'autoimproveJob',
         methodName: 'cancel',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix/{fixId}/cancel',
-        summary: 'Cancel a fix',
-        description: 'Stop a live fix. Production is never changed by a cancel; everything the fix set up (the shadow agent, its phone number, authored test flows and run plan) is cleaned up automatically.',
+        httpPath: '/v1/autoimprove/job/{jobId}/cancel',
+        summary: 'Cancel a job',
+        description: 'Stop a live job. Production is never changed by a cancel; everything the job set up (the shadow agent, its phone number, authored test flows and run plan) is cleaned up automatically.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [],
@@ -538,13 +538,13 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'create'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'create'],
+        clientProperty: 'autoimproveJob',
         methodName: 'create',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix',
-        summary: 'Start an Autoimprove fix',
-        description: 'Commission Roark on an objective. It clones the agent into a staging shadow (or uses your designated staging agent), authors a validation suite of simulated callers, measures a baseline, changes the staging configuration, and re-tests until the objective metric passes its target. Production is never touched by the loop; a verified fix waits for promotion. Requires an active provider integration (Vapi or Retell) with agent config writes enabled. One live fix per agent: starting a second returns a conflict. The fix runs asynchronously; poll GET /v1/autoimprove/fix/{fixId} or watch it in the dashboard. When its status is NEEDS_INPUT, answer via the answer endpoint; when AWAITING_PROMOTE, promote or dismiss.',
+        httpPath: '/v1/autoimprove/job',
+        summary: 'Start an Autoimprove job',
+        description: 'Commission Roark on an objective. It clones the agent into a staging shadow (or uses your designated staging agent), authors a validation suite of simulated callers, measures a baseline, changes the staging configuration, and re-tests until the objective metric passes its target. Production is never touched by the loop; verified changes wait for promotion. Requires an active provider integration (Vapi or Retell) with agent config writes enabled. One live job per agent: starting a second returns a conflict. The job runs asynchronously; poll GET /v1/autoimprove/job/{jobId} or watch it in the dashboard. When its status is NEEDS_INPUT, answer via the answer endpoint; when AWAITING_PROMOTE, promote or dismiss.',
         positionals: [],
         flags: [
             {
@@ -570,7 +570,7 @@ exports.COMMANDS = [
                 path: ['objectiveLabel'],
                 location: 'body',
                 required: true,
-                description: 'Human-readable label for the objective, shown everywhere the fix appears.',
+                description: 'Human-readable label for the objective, shown everywhere the job appears.',
                 valueKind: 'string',
                 repeatable: false,
             },
@@ -615,7 +615,7 @@ exports.COMMANDS = [
                 path: ['maxIterations'],
                 location: 'body',
                 required: false,
-                description: 'Cap on decision turns. Defaults to 10.',
+                description: 'Cap on decision turns. Defaults to 50.',
                 valueKind: 'integer',
                 repeatable: false,
             },
@@ -637,17 +637,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'dismiss'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'dismiss'],
+        clientProperty: 'autoimproveJob',
         methodName: 'dismiss',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix/{fixId}/dismiss',
-        summary: 'Dismiss a verified fix',
-        description: 'Discard a verified fix without promoting: production stays untouched and the staging resources are cleaned up. Only a fix in AWAITING_PROMOTE can be dismissed.',
+        httpPath: '/v1/autoimprove/job/{jobId}/dismiss',
+        summary: 'Dismiss a verified job',
+        description: 'Discard a verified job without promoting: production stays untouched and the staging resources are cleaned up. Only a job in AWAITING_PROMOTE can be dismissed.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [],
@@ -659,17 +659,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'get'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'get'],
+        clientProperty: 'autoimproveJob',
         methodName: 'getByID',
         httpMethod: 'get',
-        httpPath: '/v1/autoimprove/fix/{fixId}',
-        summary: 'Get an Autoimprove fix',
-        description: 'Fetch one fix with its full worklog: every step Roark took, the validation batches with their pass-rate movement, any question it is waiting on, and its final report once concluded.',
+        httpPath: '/v1/autoimprove/job/{jobId}',
+        summary: 'Get an Autoimprove job',
+        description: 'Fetch one job with its full worklog: every step Roark took, the validation batches with their pass-rate movement, any question it is waiting on, and its final report once concluded.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [],
@@ -681,17 +681,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'guidance', 'send'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'guidance', 'send'],
+        clientProperty: 'autoimproveJob',
         methodName: 'sendGuidance',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix/{fixId}/guidance',
-        summary: 'Send guidance to a running fix',
-        description: 'Steer Roark mid-fix. The message is folded into its next decision and is binding. Accepted while the fix is live (RUNNING, NEEDS_INPUT, or PAUSED); a concluded fix returns a conflict.',
+        httpPath: '/v1/autoimprove/job/{jobId}/guidance',
+        summary: 'Send guidance to a running job',
+        description: 'Steer Roark mid-job. The message is folded into its next decision and is binding. Accepted while the job is live (RUNNING, NEEDS_INPUT, or PAUSED); a concluded job returns a conflict.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [
@@ -713,13 +713,13 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'list'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'list'],
+        clientProperty: 'autoimproveJob',
         methodName: 'list',
         httpMethod: 'get',
-        httpPath: '/v1/autoimprove/fix',
-        summary: 'List Autoimprove fixes',
-        description: 'List the Autoimprove fixes in this project, most recent first, capped at 100. A fix is one autonomous engagement: Roark improving one agent toward one objective metric on a staging copy, with a human-gated promote to production at the end.',
+        httpPath: '/v1/autoimprove/job',
+        summary: 'List Autoimprove jobs',
+        description: 'List the Autoimprove jobs in this project, most recent first, capped at 100. A job is one autonomous engagement: Roark improving one agent toward one objective metric on a staging copy, with a human-gated promote to production at the end.',
         positionals: [],
         flags: [],
         hasParams: false,
@@ -730,17 +730,17 @@ exports.COMMANDS = [
         requiresAuth: true,
     },
     {
-        commandPath: ['autoimprove', 'fix', 'promote'],
-        clientProperty: 'autoimproveFix',
+        commandPath: ['autoimprove', 'job', 'promote'],
+        clientProperty: 'autoimproveJob',
         methodName: 'promote',
         httpMethod: 'post',
-        httpPath: '/v1/autoimprove/fix/{fixId}/promote',
-        summary: 'Promote a verified fix to production',
-        description: 'Apply the verified staging changes to the PRODUCTION agent. Only a fix in AWAITING_PROMOTE can be promoted. A snapshot of the production configuration is taken immediately before the write, so the promote is fully rollbackable. After the promote the staging shadow and its phone number are cleaned up.',
+        httpPath: '/v1/autoimprove/job/{jobId}/promote',
+        summary: 'Promote a verified job to production',
+        description: 'Apply the verified staging changes to the PRODUCTION agent. Only a job in AWAITING_PROMOTE can be promoted. A snapshot of the production configuration is taken immediately before the write, so the promote is fully rollbackable. After the promote the staging shadow and its phone number are cleaned up.',
         positionals: [
             {
-                name: 'fix-id',
-                paramKey: 'fixId',
+                name: 'job-id',
+                paramKey: 'jobId',
             },
         ],
         flags: [],