@roarkanalytics/cli 0.39.0 → 0.42.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,40 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.42.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.42.0...v0.42.1) (2026-10-15)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * **deps:** raise the @roarkanalytics/sdk floor to 5.4.0 ([#107](https://github.com/roarkhq/cli-roark-analytics/issues/107)) ([518a28a](https://github.com/roarkhq/cli-roark-analytics/commit/518a28a7c04d3120182fa1a9c2e923f7157c3e8f))
9
+
10
+ ## [0.42.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.41.1...v0.42.0) (2026-10-14)
11
+
12
+
13
+ ### Features
14
+
15
+ * **cli:** cli update ([#105](https://github.com/roarkhq/cli-roark-analytics/issues/105)) ([a37560d](https://github.com/roarkhq/cli-roark-analytics/commit/a37560d504352a7c11cbcbcea8677cdb458d65a0))
16
+
17
+ ## [0.41.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.41.0...v0.41.1) (2026-10-12)
18
+
19
+
20
+ ### Bug Fixes
21
+
22
+ * **deps:** raise the @roarkanalytics/sdk floor to 5.3.0 ([#103](https://github.com/roarkhq/cli-roark-analytics/issues/103)) ([0148563](https://github.com/roarkhq/cli-roark-analytics/commit/0148563a7619a6275f76077643d05830570dd32d))
23
+
24
+ ## [0.41.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.40.0...v0.41.0) (2026-10-12)
25
+
26
+
27
+ ### Features
28
+
29
+ * **cli:** cli update ([#101](https://github.com/roarkhq/cli-roark-analytics/issues/101)) ([77715f6](https://github.com/roarkhq/cli-roark-analytics/commit/77715f623719fdf28ad6acea7ff24b732fe25790))
30
+
31
+ ## [0.40.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.39.0...v0.40.0) (2026-10-11)
32
+
33
+
34
+ ### Features
35
+
36
+ * **cli:** cli update ([#99](https://github.com/roarkhq/cli-roark-analytics/issues/99)) ([0e7671a](https://github.com/roarkhq/cli-roark-analytics/commit/0e7671a8eb1c6849a66b2c470abf872495b8a7ed))
37
+
3
38
  ## [0.39.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.38.0...v0.39.0) (2026-10-08)
4
39
 
5
40
 
package/README.md CHANGED
@@ -253,6 +253,12 @@ roark completion fish | source
253
253
  | `roark simulation environment get <environment-id>` | Get environment by ID |
254
254
  | `roark simulation environment list` | List environments |
255
255
  | `roark simulation environment update <environment-id>` | Update an environment |
256
+ | `roark simulation group create --name <value> --simulation-run-plan-ids <value>` | Create a simulation group |
257
+ | `roark simulation group delete <group-id>` | Delete a simulation group |
258
+ | `roark simulation group get <group-id>` | Get a simulation group |
259
+ | `roark simulation group list` | List simulation groups |
260
+ | `roark simulation group run <group-id>` | Run a simulation group |
261
+ | `roark simulation group update <group-id>` | Update a simulation group |
256
262
  | `roark simulation job get <job-id>` | Get simulation by ID |
257
263
  | `roark simulation job lookup --roark-phone-number <value>` | Lookup by phone number |
258
264
  | `roark simulation job tool-mock list <job-id>` | List mocked tool invocations |
@@ -264,12 +270,19 @@ roark completion fish | source
264
270
  | `roark simulation plan delete <plan-id>` | Delete a run plan |
265
271
  | `roark simulation plan get <plan-id>` | Get run plan by ID |
266
272
  | `roark simulation plan job cancel <job-id>` | Cancel a simulation plan job |
273
+ | `roark simulation plan job debrief create <job-id>` | Generate simulation run debrief |
267
274
  | `roark simulation plan job get <job-id>` | Get simulation plan job |
268
275
  | `roark simulation plan job list` | List simulation plan jobs |
276
+ | `roark simulation plan job result get <job-id>` | Get simulation run results |
269
277
  | `roark simulation plan job start <plan-id>` | Run a simulation plan |
270
278
  | `roark simulation plan list` | List run plans |
271
279
  | `roark simulation plan update <plan-id>` | Update a run plan |
272
280
  | `roark simulation run --data '{ ... }'` | Run a simulation |
281
+ | `roark simulation run-group create` | Create a run group |
282
+ | `roark simulation run-group delete <group-id>` | Delete a run group |
283
+ | `roark simulation run-group get <group-id>` | Get a run group |
284
+ | `roark simulation run-group list` | List run groups |
285
+ | `roark simulation run-group report regenerate <group-id>` | Regenerate a run group report |
273
286
  | `roark simulation template list` | List simulation templates |
274
287
  | `roark simulation tool mock --simulation-job-id <value> --tool-name <value>` | Mock a tool call during a test call |
275
288
  | `roark simulation tool-fixture create --tool-name <value>` | Set a tool fixture |
package/commands.js CHANGED
@@ -44,11 +44,16 @@ exports.GROUPS = {
44
44
  project: 'Read projects',
45
45
  simulation: 'Manage simulations',
46
46
  'simulation environment': 'Manage simulation environments',
47
+ 'simulation group': 'Manage simulation groups',
47
48
  'simulation job': 'Read simulation jobs',
48
49
  'simulation job tool-mock': 'Read simulation job tool mocks',
49
50
  'simulation persona': 'Manage simulation personas',
50
51
  'simulation plan': 'Manage simulation plans',
51
52
  'simulation plan job': 'Manage simulation plan jobs',
53
+ 'simulation plan job debrief': 'Manage simulation plan job debrief',
54
+ 'simulation plan job result': 'Read simulation plan job result',
55
+ 'simulation run-group': 'Manage simulation run groups',
56
+ 'simulation run-group report': 'Read simulation run group report',
52
57
  'simulation template': 'Read simulation templates',
53
58
  'simulation tool': 'Read simulation tool',
54
59
  'simulation tool-fixture': 'Manage simulation tool fixtures',
@@ -3953,6 +3958,256 @@ exports.COMMANDS = [
3953
3958
  acceptsBody: true,
3954
3959
  requiresAuth: true,
3955
3960
  },
3961
+ {
3962
+ commandPath: ['simulation', 'group', 'create'],
3963
+ clientProperty: 'simulationGroup',
3964
+ methodName: 'create',
3965
+ httpMethod: 'post',
3966
+ httpPath: '/v1/simulation/group',
3967
+ summary: 'Create a simulation group',
3968
+ description: 'Saves a named set of plans to run together, again and again. Nothing runs yet: POST /v1/simulation/group/{groupId}/run starts one run of every plan and groups them into a run group with one combined report. Slack channels need Slack connected to the project. Email is on by default.',
3969
+ positionals: [],
3970
+ flags: [
3971
+ {
3972
+ name: 'name',
3973
+ path: ['name'],
3974
+ location: 'body',
3975
+ required: true,
3976
+ description: 'What to call the group.',
3977
+ valueKind: 'string',
3978
+ repeatable: false,
3979
+ },
3980
+ {
3981
+ name: 'description',
3982
+ path: ['description'],
3983
+ location: 'body',
3984
+ required: false,
3985
+ description: 'What the group is for.',
3986
+ valueKind: 'string',
3987
+ repeatable: false,
3988
+ },
3989
+ {
3990
+ name: 'simulation-run-plan-ids',
3991
+ path: ['simulationRunPlanIds'],
3992
+ location: 'body',
3993
+ required: true,
3994
+ description: 'The plans to run together, in run order (2 to 20). Duplicates are dropped.',
3995
+ valueKind: 'array',
3996
+ repeatable: true,
3997
+ },
3998
+ {
3999
+ name: 'notifications',
4000
+ path: ['notifications'],
4001
+ location: 'body',
4002
+ required: false,
4003
+ description: "Where each run's group report announces itself once it is ready.",
4004
+ valueKind: 'object',
4005
+ },
4006
+ {
4007
+ name: 'notifications.email',
4008
+ path: ['notifications', 'email'],
4009
+ location: 'body',
4010
+ required: false,
4011
+ valueKind: 'object',
4012
+ repeatable: false,
4013
+ },
4014
+ {
4015
+ name: 'notifications.slack',
4016
+ path: ['notifications', 'slack'],
4017
+ location: 'body',
4018
+ required: false,
4019
+ description: "Channels in the project's connected Slack workspace to post the report to (at most 10). Slack must be connected to the project first.",
4020
+ valueKind: 'array',
4021
+ repeatable: false,
4022
+ },
4023
+ ],
4024
+ hasParams: true,
4025
+ paramsAllOptional: false,
4026
+ bodyOpaque: false,
4027
+ bodyVariants: [],
4028
+ acceptsBody: true,
4029
+ requiresAuth: true,
4030
+ },
4031
+ {
4032
+ commandPath: ['simulation', 'group', 'delete'],
4033
+ clientProperty: 'simulationGroup',
4034
+ methodName: 'delete',
4035
+ httpMethod: 'delete',
4036
+ httpPath: '/v1/simulation/group/{groupId}',
4037
+ summary: 'Delete a simulation group',
4038
+ description: 'Deletes a saved simulation group and any schedules that run it. Run groups it already started, and their reports, stay. A group managed by config as code returns 409.',
4039
+ positionals: [
4040
+ {
4041
+ name: 'group-id',
4042
+ paramKey: 'groupId',
4043
+ description: 'The simulation group ID',
4044
+ },
4045
+ ],
4046
+ flags: [],
4047
+ hasParams: false,
4048
+ paramsAllOptional: true,
4049
+ bodyOpaque: false,
4050
+ bodyVariants: [],
4051
+ acceptsBody: false,
4052
+ requiresAuth: true,
4053
+ },
4054
+ {
4055
+ commandPath: ['simulation', 'group', 'get'],
4056
+ clientProperty: 'simulationGroup',
4057
+ methodName: 'getByID',
4058
+ httpMethod: 'get',
4059
+ httpPath: '/v1/simulation/group/{groupId}',
4060
+ summary: 'Get a simulation group',
4061
+ description: 'Returns a saved simulation group with its plans in run order and notification settings.',
4062
+ positionals: [
4063
+ {
4064
+ name: 'group-id',
4065
+ paramKey: 'groupId',
4066
+ description: 'The simulation group ID',
4067
+ },
4068
+ ],
4069
+ flags: [],
4070
+ hasParams: false,
4071
+ paramsAllOptional: true,
4072
+ bodyOpaque: false,
4073
+ bodyVariants: [],
4074
+ acceptsBody: false,
4075
+ requiresAuth: true,
4076
+ },
4077
+ {
4078
+ commandPath: ['simulation', 'group', 'list'],
4079
+ clientProperty: 'simulationGroup',
4080
+ methodName: 'list',
4081
+ httpMethod: 'get',
4082
+ httpPath: '/v1/simulation/group',
4083
+ summary: 'List simulation groups',
4084
+ description: 'Returns the saved simulation groups in the project, most recently edited first, each with its plans in run order and notification settings.',
4085
+ positionals: [],
4086
+ flags: [
4087
+ {
4088
+ name: 'limit',
4089
+ path: ['limit'],
4090
+ location: 'query',
4091
+ required: false,
4092
+ description: 'Maximum number of groups to return (default: 20, max: 100)',
4093
+ valueKind: 'integer',
4094
+ repeatable: false,
4095
+ },
4096
+ {
4097
+ name: 'offset',
4098
+ path: ['offset'],
4099
+ location: 'query',
4100
+ required: false,
4101
+ description: 'Pagination offset',
4102
+ valueKind: 'integer',
4103
+ repeatable: false,
4104
+ },
4105
+ ],
4106
+ hasParams: true,
4107
+ paramsAllOptional: true,
4108
+ bodyOpaque: false,
4109
+ bodyVariants: [],
4110
+ acceptsBody: false,
4111
+ requiresAuth: true,
4112
+ },
4113
+ {
4114
+ commandPath: ['simulation', 'group', 'run'],
4115
+ clientProperty: 'simulationGroup',
4116
+ methodName: 'run',
4117
+ httpMethod: 'post',
4118
+ httpPath: '/v1/simulation/group/{groupId}/run',
4119
+ summary: 'Run a simulation group',
4120
+ description: "Starts one run of every plan in the group, exactly as POST /v1/simulation/plan/{planId}/job would for each, and groups the runs into a run group whose combined report is announced through the group's notification settings once it is ready. This places real calls. Config-managed groups can be run here too. Returns the run group. Poll GET /v1/simulation/run-group/{groupId} until `latestReport.status` is READY. If a plan cannot start after others did, the runs that started are still grouped and the 400 names the run group id.",
4121
+ positionals: [
4122
+ {
4123
+ name: 'group-id',
4124
+ paramKey: 'groupId',
4125
+ description: 'The simulation group ID',
4126
+ },
4127
+ ],
4128
+ flags: [],
4129
+ hasParams: false,
4130
+ paramsAllOptional: true,
4131
+ bodyOpaque: false,
4132
+ bodyVariants: [],
4133
+ acceptsBody: false,
4134
+ requiresAuth: true,
4135
+ },
4136
+ {
4137
+ commandPath: ['simulation', 'group', 'update'],
4138
+ clientProperty: 'simulationGroup',
4139
+ methodName: 'update',
4140
+ httpMethod: 'put',
4141
+ httpPath: '/v1/simulation/group/{groupId}',
4142
+ summary: 'Update a simulation group',
4143
+ description: 'Edits a saved simulation group. Omitted fields keep their current value; `notifications`, when sent, replaces the settings as a whole. Run groups it already started keep theirs. A group managed by config as code (`configManaged: true`) returns 409: change it in the config file.',
4144
+ positionals: [
4145
+ {
4146
+ name: 'group-id',
4147
+ paramKey: 'groupId',
4148
+ description: 'The simulation group ID',
4149
+ },
4150
+ ],
4151
+ flags: [
4152
+ {
4153
+ name: 'name',
4154
+ path: ['name'],
4155
+ location: 'body',
4156
+ required: false,
4157
+ valueKind: 'string',
4158
+ repeatable: false,
4159
+ },
4160
+ {
4161
+ name: 'description',
4162
+ path: ['description'],
4163
+ location: 'body',
4164
+ required: false,
4165
+ description: 'Send null to clear it.',
4166
+ valueKind: 'string',
4167
+ repeatable: false,
4168
+ },
4169
+ {
4170
+ name: 'simulation-run-plan-ids',
4171
+ path: ['simulationRunPlanIds'],
4172
+ location: 'body',
4173
+ required: false,
4174
+ description: 'Replaces the plans, in run order.',
4175
+ valueKind: 'array',
4176
+ repeatable: true,
4177
+ },
4178
+ {
4179
+ name: 'notifications',
4180
+ path: ['notifications'],
4181
+ location: 'body',
4182
+ required: false,
4183
+ description: "Where each run's group report announces itself once it is ready.",
4184
+ valueKind: 'object',
4185
+ },
4186
+ {
4187
+ name: 'notifications.email',
4188
+ path: ['notifications', 'email'],
4189
+ location: 'body',
4190
+ required: false,
4191
+ valueKind: 'object',
4192
+ repeatable: false,
4193
+ },
4194
+ {
4195
+ name: 'notifications.slack',
4196
+ path: ['notifications', 'slack'],
4197
+ location: 'body',
4198
+ required: false,
4199
+ description: "Channels in the project's connected Slack workspace to post the report to (at most 10). Slack must be connected to the project first.",
4200
+ valueKind: 'array',
4201
+ repeatable: false,
4202
+ },
4203
+ ],
4204
+ hasParams: true,
4205
+ paramsAllOptional: true,
4206
+ bodyOpaque: false,
4207
+ bodyVariants: [],
4208
+ acceptsBody: true,
4209
+ requiresAuth: true,
4210
+ },
3956
4211
  {
3957
4212
  commandPath: ['simulation', 'job', 'get'],
3958
4213
  clientProperty: 'simulationJob',
@@ -4889,6 +5144,38 @@ exports.COMMANDS = [
4889
5144
  acceptsBody: false,
4890
5145
  requiresAuth: true,
4891
5146
  },
5147
+ {
5148
+ commandPath: ['simulation', 'plan', 'job', 'debrief', 'create'],
5149
+ clientProperty: 'simulationRunPlanJob',
5150
+ methodName: 'createDebrief',
5151
+ httpMethod: 'post',
5152
+ httpPath: '/v1/simulation/plan/job/{jobId}/debrief',
5153
+ summary: 'Generate simulation run debrief',
5154
+ description: 'Request the written debrief for a settled run: executive summary, failure themes and recommendations. Runs with graded calls get one automatically, so this is for regenerating one (`regenerate: true`) or retrying one that failed. Returns immediately. Generation takes a few minutes: poll GET /v1/simulation/plan/job/{jobId}/results until `debrief.status` is READY or FAILED. Without `regenerate`, a debrief that is ready or already being written is returned as-is.',
5155
+ positionals: [
5156
+ {
5157
+ name: 'job-id',
5158
+ paramKey: 'jobId',
5159
+ },
5160
+ ],
5161
+ flags: [
5162
+ {
5163
+ name: 'regenerate',
5164
+ path: ['regenerate'],
5165
+ location: 'body',
5166
+ required: false,
5167
+ description: 'Generate a new debrief even when a ready one exists. Without it, an existing ready or in-progress debrief is returned as-is.',
5168
+ valueKind: 'boolean',
5169
+ repeatable: false,
5170
+ },
5171
+ ],
5172
+ hasParams: true,
5173
+ paramsAllOptional: true,
5174
+ bodyOpaque: false,
5175
+ bodyVariants: [],
5176
+ acceptsBody: true,
5177
+ requiresAuth: true,
5178
+ },
4892
5179
  {
4893
5180
  commandPath: ['simulation', 'plan', 'job', 'get'],
4894
5181
  clientProperty: 'simulationRunPlanJob',
@@ -4998,6 +5285,38 @@ exports.COMMANDS = [
4998
5285
  acceptsBody: false,
4999
5286
  requiresAuth: true,
5000
5287
  },
5288
+ {
5289
+ commandPath: ['simulation', 'plan', 'job', 'result', 'get'],
5290
+ clientProperty: 'simulationRunPlanJob',
5291
+ methodName: 'getResults',
5292
+ httpMethod: 'get',
5293
+ httpPath: '/v1/simulation/plan/job/{jobId}/results',
5294
+ summary: 'Get simulation run results',
5295
+ description: 'Everything the run report shows, in one request: the summary and score, the pass/fail verdict, per-metric aggregates, every simulation with its check results, breakdowns by agent and persona, the comparison against the previous run (or `compareToJobId`), the sweep attribution, and the written debrief with its executive summary, failure themes and recommendations. Safe to call while the run is in progress: counts reflect what has landed so far. `verdict` and `sweepAttribution` stay null until the run ends. The debrief is generated automatically a few minutes after a run with graded calls settles; poll until `debrief.status` is READY, or request one with POST /v1/simulation/plan/job/{jobId}/debrief.',
5296
+ positionals: [
5297
+ {
5298
+ name: 'job-id',
5299
+ paramKey: 'jobId',
5300
+ },
5301
+ ],
5302
+ flags: [
5303
+ {
5304
+ name: 'compare-to-job-id',
5305
+ path: ['compareToJobId'],
5306
+ location: 'query',
5307
+ required: false,
5308
+ description: "Simulation run plan job to compare this run against, e.g. the last run on your main branch. Defaults to the plan's previous settled run. Any run in the project works, including another plan's: checks are matched by metric, and a check only one run graded reads null on the other side.",
5309
+ valueKind: 'string',
5310
+ repeatable: false,
5311
+ },
5312
+ ],
5313
+ hasParams: true,
5314
+ paramsAllOptional: true,
5315
+ bodyOpaque: false,
5316
+ bodyVariants: [],
5317
+ acceptsBody: false,
5318
+ requiresAuth: true,
5319
+ },
5001
5320
  {
5002
5321
  commandPath: ['simulation', 'plan', 'job', 'start'],
5003
5322
  clientProperty: 'simulationRunPlanJob',
@@ -5373,6 +5692,156 @@ exports.COMMANDS = [
5373
5692
  acceptsBody: true,
5374
5693
  requiresAuth: true,
5375
5694
  },
5695
+ {
5696
+ commandPath: ['simulation', 'run-group', 'create'],
5697
+ clientProperty: 'simulationRunGroup',
5698
+ methodName: 'create',
5699
+ httpMethod: 'post',
5700
+ httpPath: '/v1/simulation/run-group',
5701
+ summary: 'Create a run group',
5702
+ description: 'Groups several simulation runs so they read as one, and starts generating the group report: one document across every run, with a scorecard summed across them and the issues found, each merged from the per-run debriefs. Send `simulationRunPlanJobIds` to group runs that already exist (runs still in progress are fine: the report waits for them). Send `simulationRunPlanIds` to start one run of each plan and group those; this places real calls, exactly as starting each plan would. Poll GET /v1/simulation/run-group/{groupId} until `latestReport.status` is READY.',
5703
+ positionals: [],
5704
+ flags: [
5705
+ {
5706
+ name: 'name',
5707
+ path: ['name'],
5708
+ location: 'body',
5709
+ required: false,
5710
+ description: "What to call the group. Defaults to the plans' names when starting plans, and to the runs' plan names when grouping existing runs.",
5711
+ valueKind: 'string',
5712
+ repeatable: false,
5713
+ },
5714
+ {
5715
+ name: 'simulation-run-plan-job-ids',
5716
+ path: ['simulationRunPlanJobIds'],
5717
+ location: 'body',
5718
+ required: false,
5719
+ description: 'Runs that already exist, in display order (2 to 20). Runs still in progress are fine: the group report waits for them. Send this or `simulationRunPlanIds`, not both.',
5720
+ valueKind: 'array',
5721
+ repeatable: true,
5722
+ },
5723
+ {
5724
+ name: 'simulation-run-plan-ids',
5725
+ path: ['simulationRunPlanIds'],
5726
+ location: 'body',
5727
+ required: false,
5728
+ description: 'Plans to run once each, in display order (2 to 20). Each plan starts a run, exactly as POST /v1/simulation/plan/{planId}/job would. Send this or `simulationRunPlanJobIds`, not both.',
5729
+ valueKind: 'array',
5730
+ repeatable: true,
5731
+ },
5732
+ ],
5733
+ hasParams: true,
5734
+ paramsAllOptional: true,
5735
+ bodyOpaque: false,
5736
+ bodyVariants: [],
5737
+ acceptsBody: true,
5738
+ requiresAuth: true,
5739
+ },
5740
+ {
5741
+ commandPath: ['simulation', 'run-group', 'delete'],
5742
+ clientProperty: 'simulationRunGroup',
5743
+ methodName: 'delete',
5744
+ httpMethod: 'delete',
5745
+ httpPath: '/v1/simulation/run-group/{groupId}',
5746
+ summary: 'Delete a run group',
5747
+ description: 'Deletes a run group. Its runs, and their results, are untouched.',
5748
+ positionals: [
5749
+ {
5750
+ name: 'group-id',
5751
+ paramKey: 'groupId',
5752
+ description: 'The run group ID',
5753
+ },
5754
+ ],
5755
+ flags: [],
5756
+ hasParams: false,
5757
+ paramsAllOptional: true,
5758
+ bodyOpaque: false,
5759
+ bodyVariants: [],
5760
+ acceptsBody: false,
5761
+ requiresAuth: true,
5762
+ },
5763
+ {
5764
+ commandPath: ['simulation', 'run-group', 'get'],
5765
+ clientProperty: 'simulationRunGroup',
5766
+ methodName: 'getByID',
5767
+ httpMethod: 'get',
5768
+ httpPath: '/v1/simulation/run-group/{groupId}',
5769
+ summary: 'Get a run group',
5770
+ description: 'Returns a run group with its runs in group order and its latest group report, including the report document once READY.',
5771
+ positionals: [
5772
+ {
5773
+ name: 'group-id',
5774
+ paramKey: 'groupId',
5775
+ description: 'The run group ID',
5776
+ },
5777
+ ],
5778
+ flags: [],
5779
+ hasParams: false,
5780
+ paramsAllOptional: true,
5781
+ bodyOpaque: false,
5782
+ bodyVariants: [],
5783
+ acceptsBody: false,
5784
+ requiresAuth: true,
5785
+ },
5786
+ {
5787
+ commandPath: ['simulation', 'run-group', 'list'],
5788
+ clientProperty: 'simulationRunGroup',
5789
+ methodName: 'list',
5790
+ httpMethod: 'get',
5791
+ httpPath: '/v1/simulation/run-group',
5792
+ summary: 'List run groups',
5793
+ description: 'Returns the run groups in the project, newest first, with their runs and where each group report stands. Read a report document from GET /v1/simulation/run-group/{groupId}.',
5794
+ positionals: [],
5795
+ flags: [
5796
+ {
5797
+ name: 'limit',
5798
+ path: ['limit'],
5799
+ location: 'query',
5800
+ required: false,
5801
+ description: 'Maximum number of run groups to return (default: 20, max: 100)',
5802
+ valueKind: 'integer',
5803
+ repeatable: false,
5804
+ },
5805
+ {
5806
+ name: 'offset',
5807
+ path: ['offset'],
5808
+ location: 'query',
5809
+ required: false,
5810
+ description: 'Pagination offset',
5811
+ valueKind: 'integer',
5812
+ repeatable: false,
5813
+ },
5814
+ ],
5815
+ hasParams: true,
5816
+ paramsAllOptional: true,
5817
+ bodyOpaque: false,
5818
+ bodyVariants: [],
5819
+ acceptsBody: false,
5820
+ requiresAuth: true,
5821
+ },
5822
+ {
5823
+ commandPath: ['simulation', 'run-group', 'report', 'regenerate'],
5824
+ clientProperty: 'simulationRunGroup',
5825
+ methodName: 'regenerateReport',
5826
+ httpMethod: 'post',
5827
+ httpPath: '/v1/simulation/run-group/{groupId}/report',
5828
+ summary: 'Regenerate a run group report',
5829
+ description: 'Generates the group report again over the latest state of its runs. Returns the report generation; if one is already in flight it is returned instead of starting another. Poll GET /v1/simulation/run-group/{groupId} until `latestReport.status` is READY.',
5830
+ positionals: [
5831
+ {
5832
+ name: 'group-id',
5833
+ paramKey: 'groupId',
5834
+ description: 'The run group ID',
5835
+ },
5836
+ ],
5837
+ flags: [],
5838
+ hasParams: false,
5839
+ paramsAllOptional: true,
5840
+ bodyOpaque: false,
5841
+ bodyVariants: [],
5842
+ acceptsBody: false,
5843
+ requiresAuth: true,
5844
+ },
5376
5845
  {
5377
5846
  commandPath: ['simulation', 'template', 'list'],
5378
5847
  clientProperty: 'simulationTemplate',