@roarkanalytics/cli 0.61.1 → 0.68.0

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.
Files changed (68) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/README.md +45 -0
  3. package/commands.js +575 -0
  4. package/completions.js +4 -4
  5. package/man/roark-calendar-connection-check.1 +93 -0
  6. package/man/roark-calendar-connection-create.1 +102 -0
  7. package/man/roark-calendar-connection-delete.1 +93 -0
  8. package/man/roark-calendar-connection-get.1 +93 -0
  9. package/man/roark-calendar-connection-list.1 +93 -0
  10. package/man/roark-calendar-connection-target-get.1 +96 -0
  11. package/man/roark-calendar-connection-target-list.1 +93 -0
  12. package/man/roark-calendar-connection-update.1 +103 -0
  13. package/man/roark-metric-definition-update.1 +3 -0
  14. package/man/roark-metric-variant-update.1 +3 -0
  15. package/man/roark-tool-create.1 +123 -0
  16. package/man/roark-tool-delete.1 +93 -0
  17. package/man/roark-tool-get.1 +93 -0
  18. package/man/roark-tool-list.1 +96 -0
  19. package/man/roark-tool-update.1 +127 -0
  20. package/man/roark.1 +39 -0
  21. package/npm-shrinkwrap.json +6 -6
  22. package/package.json +15 -2
  23. package/runtime/commands/config-as-code.js +5 -23
  24. package/runtime/commands/get-started.d.ts +34 -0
  25. package/runtime/commands/get-started.js +350 -0
  26. package/runtime/config-bundle.d.ts +10 -0
  27. package/runtime/config-bundle.js +14 -3
  28. package/runtime/config-changes.d.ts +15 -0
  29. package/runtime/config-changes.js +32 -0
  30. package/runtime/get-started/account.d.ts +18 -0
  31. package/runtime/get-started/account.js +35 -0
  32. package/runtime/get-started/agent.d.ts +17 -0
  33. package/runtime/get-started/agent.js +116 -0
  34. package/runtime/get-started/answers.d.ts +15 -0
  35. package/runtime/get-started/answers.js +42 -0
  36. package/runtime/get-started/apply.d.ts +35 -0
  37. package/runtime/get-started/apply.js +54 -0
  38. package/runtime/get-started/existing.d.ts +15 -0
  39. package/runtime/get-started/existing.js +47 -0
  40. package/runtime/get-started/ladder.d.ts +37 -0
  41. package/runtime/get-started/ladder.js +69 -0
  42. package/runtime/get-started/module.d.ts +20 -0
  43. package/runtime/get-started/module.js +159 -0
  44. package/runtime/get-started/placeholder.d.ts +9 -0
  45. package/runtime/get-started/placeholder.js +36 -0
  46. package/runtime/get-started/prompt.d.ts +32 -0
  47. package/runtime/get-started/prompt.js +132 -0
  48. package/runtime/get-started/resources.d.ts +106 -0
  49. package/runtime/get-started/resources.js +184 -0
  50. package/runtime/get-started/run.d.ts +42 -0
  51. package/runtime/get-started/run.js +101 -0
  52. package/runtime/get-started/scaffold-only.d.ts +19 -0
  53. package/runtime/get-started/scaffold-only.js +43 -0
  54. package/runtime/get-started/scaffold.d.ts +15 -0
  55. package/runtime/get-started/scaffold.js +35 -0
  56. package/runtime/get-started/starter-metrics.d.ts +33 -0
  57. package/runtime/get-started/starter-metrics.js +104 -0
  58. package/runtime/get-started/steps.d.ts +33 -0
  59. package/runtime/get-started/steps.js +112 -0
  60. package/runtime/get-started/target.d.ts +47 -0
  61. package/runtime/get-started/target.js +81 -0
  62. package/runtime/get-started/types.d.ts +18 -0
  63. package/runtime/get-started/types.js +8 -0
  64. package/runtime/get-started/watch.d.ts +57 -0
  65. package/runtime/get-started/watch.js +103 -0
  66. package/runtime/program.js +5 -0
  67. package/version.d.ts +1 -1
  68. package/version.js +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,61 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.68.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.67.1...v0.68.0) (2026-11-05)
4
+
5
+
6
+ ### Features
7
+
8
+ * **cli:** `roark get-started`, a guided first simulation ([#143](https://github.com/roarkhq/cli-roark-analytics/issues/143)) ([a3290dd](https://github.com/roarkhq/cli-roark-analytics/commit/a3290dd1e3611ac22c6d4faac85f43223fb84e3b))
9
+
10
+ ## [0.67.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.67.0...v0.67.1) (2026-11-05)
11
+
12
+
13
+ ### Bug Fixes
14
+
15
+ * **deps:** raise the SDK floor to 7.0.0, which carries the commands the table names ([#175](https://github.com/roarkhq/cli-roark-analytics/issues/175)) ([578caad](https://github.com/roarkhq/cli-roark-analytics/commit/578caad631aea114ee9029288d1f224e8ba59726))
16
+
17
+ ## [0.67.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.66.0...v0.67.0) (2026-11-04)
18
+
19
+
20
+ ### Features
21
+
22
+ * **cli:** cli update ([#173](https://github.com/roarkhq/cli-roark-analytics/issues/173)) ([76c5a17](https://github.com/roarkhq/cli-roark-analytics/commit/76c5a17ac138e771d2257fea4b124126f3fec00a))
23
+
24
+ ## [0.66.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.65.0...v0.66.0) (2026-11-04)
25
+
26
+
27
+ ### Features
28
+
29
+ * **cli:** cli update ([#171](https://github.com/roarkhq/cli-roark-analytics/issues/171)) ([0762894](https://github.com/roarkhq/cli-roark-analytics/commit/07628948e3269dae57e035adaf9c7449bee97e50))
30
+
31
+ ## [0.65.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.64.0...v0.65.0) (2026-11-04)
32
+
33
+
34
+ ### Features
35
+
36
+ * **cli:** cli update ([#169](https://github.com/roarkhq/cli-roark-analytics/issues/169)) ([6ecf752](https://github.com/roarkhq/cli-roark-analytics/commit/6ecf7525faa8b668afc89aaf79afdfcfa05f9871))
37
+
38
+ ## [0.64.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.63.0...v0.64.0) (2026-11-04)
39
+
40
+
41
+ ### Features
42
+
43
+ * **cli:** cli update ([#167](https://github.com/roarkhq/cli-roark-analytics/issues/167)) ([7a8b74d](https://github.com/roarkhq/cli-roark-analytics/commit/7a8b74d833f3336d39bbc3c7f95c3c5ddce8194b))
44
+
45
+ ## [0.63.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.62.0...v0.63.0) (2026-11-03)
46
+
47
+
48
+ ### Features
49
+
50
+ * **cli:** cli update ([#165](https://github.com/roarkhq/cli-roark-analytics/issues/165)) ([9c22e93](https://github.com/roarkhq/cli-roark-analytics/commit/9c22e93d9dcbf70fb9c4fcf7dce278d7416a74e5))
51
+
52
+ ## [0.62.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.61.1...v0.62.0) (2026-11-03)
53
+
54
+
55
+ ### Features
56
+
57
+ * **cli:** cli update ([#163](https://github.com/roarkhq/cli-roark-analytics/issues/163)) ([ae3edd0](https://github.com/roarkhq/cli-roark-analytics/commit/ae3edd04d621d9a81272d0ba91fe19e04cbe9754))
58
+
3
59
  ## [0.61.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.61.0...v0.61.1) (2026-11-03)
4
60
 
5
61
 
package/README.md CHANGED
@@ -40,6 +40,28 @@ a stored or environment credential to it. Pass `--allow-project-base-url` (or se
40
40
  `ROARK_ALLOW_PROJECT_BASE_URL`) once you have read the file, or `--token` to send a
41
41
  different credential.
42
42
 
43
+ ## Get started
44
+
45
+ ```sh
46
+ roark get-started
47
+ ```
48
+
49
+ Seven steps from an empty project to a graded simulation: the project you are in, the agent
50
+ under test, the caller that phones it, what the call is about, the metrics that grade it, the
51
+ saved run, and then the run itself. Each step writes one YAML file under `./roark` and the
52
+ directory is applied with `config apply`, so the setup is yours to commit, re-running it fills
53
+ in whatever is missing, and nothing is ever pruned.
54
+
55
+ It writes YAML by default, which needs nothing installed. In a project that has the SDK it
56
+ offers TypeScript instead: one `roark.config.ts` using the typed `define*` helpers, which
57
+ `config apply` finds by name.
58
+
59
+ ```sh
60
+ roark get-started --scaffold-only # write the config with placeholders; no questions, no API calls
61
+ roark get-started --no-run # set it all up, start the run yourself later
62
+ roark get-started --ts # TypeScript config instead of YAML
63
+ ```
64
+
43
65
  ## Usage
44
66
 
45
67
  Commands read noun before verb, and the verb is one of `list`, `get`, `create`,
@@ -173,6 +195,19 @@ roark completion fish | source
173
195
  | `roark benchmark target history list <target-key> --suite <value>` | List a target’s published generations |
174
196
  | `roark benchmark target score-sample list <target-key> --suite <value>` | List score samples for a target |
175
197
 
198
+ ### calendar-connection
199
+
200
+ | Command | Description |
201
+ | --------------------------------------------------------------------------------------- | ------------------------------------- |
202
+ | `roark calendar-connection check <connection-id>` | Check a calendar connection |
203
+ | `roark calendar-connection create --provider <value> --label <value> --api-key <value>` | Connect a calendar account |
204
+ | `roark calendar-connection delete <connection-id>` | Delete a calendar connection |
205
+ | `roark calendar-connection get <connection-id>` | Get a calendar connection |
206
+ | `roark calendar-connection list` | List calendar connections |
207
+ | `roark calendar-connection target get <connection-id> <target-id>` | Read one bookable target |
208
+ | `roark calendar-connection target list <connection-id>` | List what can be booked on a calendar |
209
+ | `roark calendar-connection update <connection-id>` | Update a calendar connection |
210
+
176
211
  ### call
177
212
 
178
213
  | Command | Description |
@@ -350,6 +385,16 @@ roark completion fish | source
350
385
  | `roark simulation tool-fixture list` | List tool fixtures |
351
386
  | `roark simulation tool-fixture update <fixture-id>` | Update a tool fixture |
352
387
 
388
+ ### tool
389
+
390
+ | Command | Description |
391
+ | -------------------------------------------------------------------------------------------- | ------------- |
392
+ | `roark tool create --name <value> --description <value> --runtime.request <value>` | Create a tool |
393
+ | `roark tool delete <tool-id>` | Delete a tool |
394
+ | `roark tool get <tool-id>` | Get a tool |
395
+ | `roark tool list` | List tools |
396
+ | `roark tool update <tool-id> --name <value> --description <value> --runtime.request <value>` | Update a tool |
397
+
353
398
  ### usage
354
399
 
355
400
  | Command | Description |