@eigenpal/cli 0.14.3 → 0.15.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.
Files changed (19) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +11 -9
  3. package/dist/cli.js +1110 -249
  4. package/dist/docs-bundle.json +1356 -0
  5. package/dist/skill/SKILL.md +33 -0
  6. package/dist/skill/reference/cli/agents.md +111 -106
  7. package/dist/skill/reference/cli/docs.md +84 -0
  8. package/dist/skill/reference/cli/models.md +1 -1
  9. package/dist/skill/reference/cli/rerun.md +1 -1
  10. package/dist/skill/reference/cli/run.md +1 -1
  11. package/dist/skill/reference/cli/runs.md +67 -67
  12. package/dist/skill/reference/cli/surface.md +4 -0
  13. package/dist/skill/reference/cli/workflow.md +114 -107
  14. package/dist/skill/reference/dataset-format.md +151 -0
  15. package/dist/skill/reference/debugging.md +9 -0
  16. package/dist/skill/reference/evaluators.md +361 -4
  17. package/dist/skill/reference/step-types.md +4519 -15
  18. package/dist/skill/reference/workflow-yaml.md +1458 -23
  19. package/package.json +7 -4
package/dist/skill/reference/cli/runs.md CHANGED
@@ -65,16 +65,16 @@ runs
65
65
 
66
66
  ### Core
67
67
 
68
- | Command | Description |
69
- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
70
- | `eigenpal runs list\|ls [options] [source]` | List runs across workflows and agents, optionally scoped to one source. |
71
- | `eigenpal runs get [options] <run-id>` | Get one run. |
72
- | `eigenpal runs compare\|diff [options] <reference-run-id> <run-id>` | Compare one run against another run. PDF/DOCX use pdftotext/python3; XLSX compares structured workbook content (not ZIP bytes). |
73
- | `eigenpal runs rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
74
- | `eigenpal runs promote [options] <run-id>` | Promote a run into a dataset example on the run's automation. |
75
- | `eigenpal runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
76
- | `eigenpal runs watch [options] <run-id>` | Watch a run until it reaches a terminal status. |
77
- | `eigenpal runs cancel [options] <run-id>` | Cancel a run. |
68
+ | Command | Description |
69
+ | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
70
+ | `eigenpal runs list\|ls [options] [source]` | List runs across workflows and agents, optionally scoped to one source. |
71
+ | `eigenpal runs get [options] <run-id>` | Get one run. |
72
+ | `eigenpal runs compare\|diff [options] <reference-run-id> <run-id>` | Compare one run against another. Repeated workflow steps are matched by stable branch/iteration path. |
73
+ | `eigenpal runs rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
74
+ | `eigenpal runs promote [options] <run-id>` | Promote a run into a dataset example on the run's automation. |
75
+ | `eigenpal runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
76
+ | `eigenpal runs watch [options] <run-id>` | Watch a run until it reaches a terminal status. |
77
+ | `eigenpal runs cancel [options] <run-id>` | Cancel a run. |
78
78
 
79
79
  ### Artifacts
80
80
 
@@ -122,7 +122,7 @@ List runs across workflows and agents, optionally scoped to one source.
122
122
  | `--base-url <url>` | no | | Server base URL |
123
123
  | `--limit <n>` | no | `50` | Page size |
124
124
  | `--offset <n>` | no | `0` | Page offset |
125
- | `--json` | no | | Output the raw server response as JSON |
125
+ | `--json` | no | | Emit machine-readable JSON on stdout |
126
126
  | `--type <type>` | no | | Filter by run type: workflow\|agent |
127
127
  | `--status <status>` | no | | Filter by run status |
128
128
  | `--source-ref <ref>` | no | | Filter agent runs by source ref |
@@ -154,14 +154,15 @@ Get one run.
154
154
  | Flag | Required | Default | Description |
155
155
  | --------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
156
156
  | `--base-url <url>` | no | | Server base URL |
157
- | `--json` | no | | Output the raw server response as JSON |
157
+ | `--json` | no | | Emit machine-readable JSON on stdout |
158
158
  | `--step <name>` | no | | For workflow runs, show only this step (or comma-separated list) |
159
+ | `--select <path>` | no | | Print only a nested JSON value; implies JSON output (for example output.subjects or output.subjects[].name) |
159
160
  | `--expand <sections>` | no | | Comma-separated server expand sections for GET /api/v1/runs/:id: input, usage, execution, debug. Use execution for status/schemaValid; completed runs include top-level output/files/error. |
160
161
  | `--include <parts>` | no | `"review"` | Comma-separated local workflow step projection fields (error, duration, inputRef, …). Legacy expand names are mapped when possible; use --expand for server sections. |
161
162
 
162
163
  ### `eigenpal runs compare|diff [options] <reference-run-id> <run-id>`
163
164
 
164
- Compare one run against another run. PDF/DOCX use pdftotext/python3; XLSX compares structured workbook content (not ZIP bytes).
165
+ Compare one run against another. Repeated workflow steps are matched by stable branch/iteration path.
165
166
 
166
167
  ### Arguments
167
168
 
@@ -172,15 +173,15 @@ Compare one run against another run. PDF/DOCX use pdftotext/python3; XLSX compar
172
173
 
173
174
  ### Options
174
175
 
175
- | Flag | Required | Default | Description |
176
- | ------------------- | -------- | ------- | ------------------------------------------------------------------- |
177
- | `--base-url <url>` | no | | Server base URL |
178
- | `--json` | no | | Output the raw server response as JSON |
179
- | `--baseline` | no | | Compare actual outputs from both runs instead of expected artifacts |
180
- | `--step <name>` | no | | For workflow runs, restrict comparison to one step |
181
- | `--out <dir>` | no | | Write comparison artifacts to this directory |
182
- | `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
183
- | `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
176
+ | Flag | Required | Default | Description |
177
+ | ----------------------- | -------- | ------- | ------------------------------------------------------------------- |
178
+ | `--base-url <url>` | no | | Server base URL |
179
+ | `--json` | no | | Emit machine-readable JSON on stdout |
180
+ | `--baseline` | no | | Compare actual outputs from both runs instead of expected artifacts |
181
+ | `--step <name-or-path>` | no | | For workflow runs, restrict by step name or stable path |
182
+ | `--out <dir>` | no | | Write comparison artifacts to this directory |
183
+ | `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
184
+ | `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
184
185
 
185
186
  ### `eigenpal runs rerun [options] <run-id>`
186
187
 
@@ -197,7 +198,7 @@ Create a new run from a previous run's stored input snapshot.
197
198
  | Flag | Required | Default | Description |
198
199
  | ---------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
199
200
  | `--base-url <url>` | no | | Server base URL |
200
- | `--json` | no | | Output the raw server response as JSON |
201
+ | `--json` | no | | Emit machine-readable JSON on stdout |
201
202
  | `--version <version>` | no | | Version/source ref for the new run: latest (default), original, or an explicit ref (same grammar as eigenpal run) |
202
203
  | `--source-ref <ref>` | no | | Alias for --version |
203
204
  | `--wait` | no | | Poll until the rerun reaches a terminal status |
@@ -216,11 +217,11 @@ Promote a run into a dataset example on the run's automation.
216
217
 
217
218
  ### Options
218
219
 
219
- | Flag | Required | Default | Description |
220
- | ------------------ | -------- | ------- | -------------------------------------- |
221
- | `--base-url <url>` | no | | Server base URL |
222
- | `--json` | no | | Output the raw server response as JSON |
223
- | `--name <name>` | no | | Name for the created example |
220
+ | Flag | Required | Default | Description |
221
+ | ------------------ | -------- | ------- | ------------------------------------ |
222
+ | `--base-url <url>` | no | | Server base URL |
223
+ | `--json` | no | | Emit machine-readable JSON on stdout |
224
+ | `--name <name>` | no | | Name for the created example |
224
225
 
225
226
  ### `eigenpal runs trace [options] <run-id>`
226
227
 
@@ -251,12 +252,12 @@ Watch a run until it reaches a terminal status.
251
252
 
252
253
  ### Options
253
254
 
254
- | Flag | Required | Default | Description |
255
- | ---------------------- | -------- | ------- | -------------------------------------- |
256
- | `--base-url <url>` | no | | Server base URL |
257
- | `--json` | no | | Output the raw server response as JSON |
258
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
259
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exit code 2 |
255
+ | Flag | Required | Default | Description |
256
+ | ---------------------- | -------- | ------- | ------------------------------------ |
257
+ | `--base-url <url>` | no | | Server base URL |
258
+ | `--json` | no | | Emit machine-readable JSON on stdout |
259
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
260
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exit code 2 |
260
261
 
261
262
  ### `eigenpal runs cancel [options] <run-id>`
262
263
 
@@ -273,7 +274,7 @@ Cancel a run.
273
274
  | Flag | Required | Default | Description |
274
275
  | ------------------ | -------- | ------- | ------------------------------------------------------------------ |
275
276
  | `--base-url <url>` | no | | Server base URL |
276
- | `--json` | no | | Output the raw server response as JSON |
277
+ | `--json` | no | | Emit machine-readable JSON on stdout |
277
278
  | `--yes` | no | | Skip confirmation (required in CI / agent terminals without a TTY) |
278
279
 
279
280
  ### `eigenpal runs artifacts|artifact list|ls [options] <run-id>`
@@ -288,10 +289,10 @@ List available run artifacts without downloading them.
288
289
 
289
290
  ### Options
290
291
 
291
- | Flag | Required | Default | Description |
292
- | ------------------ | -------- | ------- | -------------------------------------- |
293
- | `--base-url <url>` | no | | Server base URL |
294
- | `--json` | no | | Output the raw server response as JSON |
292
+ | Flag | Required | Default | Description |
293
+ | ------------------ | -------- | ------- | ------------------------------------ |
294
+ | `--base-url <url>` | no | | Server base URL |
295
+ | `--json` | no | | Emit machine-readable JSON on stdout |
295
296
 
296
297
  ### `eigenpal runs artifacts|artifact fetch [options] <run-id>`
297
298
 
@@ -329,7 +330,6 @@ Inspect a run XLSX artifact as structured JSON (sheet names, headers, typed rows
329
330
  | Flag | Required | Default | Description |
330
331
  | ------------------ | -------- | ------- | ---------------------------------------------------------------------------------- |
331
332
  | `--base-url <url>` | no | | Server base URL |
332
- | `--json` | no | | Output the raw server response as JSON |
333
333
  | `--file <path>` | no | | Inspect a local .xlsx/.xls file instead of downloading a run artifact |
334
334
  | `--path <path>` | no | | Canonical artifact path from `artifacts list` (alias for positional artifact-path) |
335
335
  | `--sheet <names>` | no | | Comma-separated sheet names or zero-based indices to include |
@@ -352,7 +352,7 @@ Edit review verdict, status, note, or corrected JSON for a run.
352
352
  | Flag | Required | Default | Description |
353
353
  | ----------------------------------- | -------- | ------- | -------------------------------------- |
354
354
  | `--base-url <url>` | no | | Server base URL |
355
- | `--json` | no | | Output the raw server response as JSON |
355
+ | `--json` | no | | Emit machine-readable JSON on stdout |
356
356
  | `--status <open\|closed\|wont_fix>` | no | | Set review lifecycle status |
357
357
  | `--verdict <correct\|incorrect>` | no | | Set reviewer verdict |
358
358
  | `--note <text>` | no | | Set review note |
@@ -374,12 +374,12 @@ Mark a run review as closed.
374
374
 
375
375
  ### Options
376
376
 
377
- | Flag | Required | Default | Description |
378
- | -------------------- | -------- | ------- | -------------------------------------- |
379
- | `--base-url <url>` | no | | Server base URL |
380
- | `--json` | no | | Output the raw server response as JSON |
381
- | `--note <text>` | no | | Set developer close note |
382
- | `--note-file <path>` | no | | Read developer close note from a file |
377
+ | Flag | Required | Default | Description |
378
+ | -------------------- | -------- | ------- | ------------------------------------- |
379
+ | `--base-url <url>` | no | | Server base URL |
380
+ | `--json` | no | | Emit machine-readable JSON on stdout |
381
+ | `--note <text>` | no | | Set developer close note |
382
+ | `--note-file <path>` | no | | Read developer close note from a file |
383
383
 
384
384
  ### `eigenpal runs reviews|rv clear [options] <run-id>`
385
385
 
@@ -396,7 +396,7 @@ Delete review metadata, corrected JSON, and corrected files for a run.
396
396
  | Flag | Required | Default | Description |
397
397
  | ------------------ | -------- | ------- | ----------------------------------------------------------------------------- |
398
398
  | `--base-url <url>` | no | | Server base URL |
399
- | `--json` | no | | Output the raw server response as JSON |
399
+ | `--json` | no | | Emit machine-readable JSON on stdout |
400
400
  | `--yes` | no | | Skip typed-slug confirmation (required in CI / agent terminals without a TTY) |
401
401
 
402
402
  ### `eigenpal runs expected list|ls [options] <run-id>`
@@ -411,10 +411,10 @@ List expected JSON and files attached to a run.
411
411
 
412
412
  ### Options
413
413
 
414
- | Flag | Required | Default | Description |
415
- | ------------------ | -------- | ------- | -------------------------------------- |
416
- | `--base-url <url>` | no | | Server base URL |
417
- | `--json` | no | | Output the raw server response as JSON |
414
+ | Flag | Required | Default | Description |
415
+ | ------------------ | -------- | ------- | ------------------------------------ |
416
+ | `--base-url <url>` | no | | Server base URL |
417
+ | `--json` | no | | Emit machine-readable JSON on stdout |
418
418
 
419
419
  ### `eigenpal runs expected pull [options] <run-id>`
420
420
 
@@ -446,11 +446,11 @@ Upload a local file as an expected artifact.
446
446
 
447
447
  ### Options
448
448
 
449
- | Flag | Required | Default | Description |
450
- | ------------------ | -------- | ------- | -------------------------------------- |
451
- | `--base-url <url>` | no | | Server base URL |
452
- | `--json` | no | | Output the raw server response as JSON |
453
- | `--name <name>` | no | | Expected artifact name |
449
+ | Flag | Required | Default | Description |
450
+ | ------------------ | -------- | ------- | ------------------------------------ |
451
+ | `--base-url <url>` | no | | Server base URL |
452
+ | `--json` | no | | Emit machine-readable JSON on stdout |
453
+ | `--name <name>` | no | | Expected artifact name |
454
454
 
455
455
  ### `eigenpal runs expected copy-output [options] <run-id> <output-file>`
456
456
 
@@ -465,11 +465,11 @@ Copy a generated output file into expected artifacts.
465
465
 
466
466
  ### Options
467
467
 
468
- | Flag | Required | Default | Description |
469
- | ------------------ | -------- | ------- | -------------------------------------- |
470
- | `--base-url <url>` | no | | Server base URL |
471
- | `--json` | no | | Output the raw server response as JSON |
472
- | `--name <name>` | no | | Expected artifact name |
468
+ | Flag | Required | Default | Description |
469
+ | ------------------ | -------- | ------- | ------------------------------------ |
470
+ | `--base-url <url>` | no | | Server base URL |
471
+ | `--json` | no | | Emit machine-readable JSON on stdout |
472
+ | `--name <name>` | no | | Expected artifact name |
473
473
 
474
474
  ### `eigenpal runs expected rename [options] <run-id> <old-name> <new-name>`
475
475
 
@@ -485,10 +485,10 @@ Rename an expected artifact.
485
485
 
486
486
  ### Options
487
487
 
488
- | Flag | Required | Default | Description |
489
- | ------------------ | -------- | ------- | -------------------------------------- |
490
- | `--base-url <url>` | no | | Server base URL |
491
- | `--json` | no | | Output the raw server response as JSON |
488
+ | Flag | Required | Default | Description |
489
+ | ------------------ | -------- | ------- | ------------------------------------ |
490
+ | `--base-url <url>` | no | | Server base URL |
491
+ | `--json` | no | | Emit machine-readable JSON on stdout |
492
492
 
493
493
  ### `eigenpal runs expected delete [options] <run-id> <name>`
494
494
 
@@ -506,5 +506,5 @@ Delete an expected artifact.
506
506
  | Flag | Required | Default | Description |
507
507
  | ------------------ | -------- | ------- | ----------------------------------------------------------------------------- |
508
508
  | `--base-url <url>` | no | | Server base URL |
509
- | `--json` | no | | Output the raw server response as JSON |
509
+ | `--json` | no | | Emit machine-readable JSON on stdout |
510
510
  | `--yes` | no | | Skip typed-slug confirmation (required in CI / agent terminals without a TTY) |
package/dist/skill/reference/cli/surface.md CHANGED
@@ -140,6 +140,10 @@ eigenpal
140
140
  │ │ └── delete <run-id> <name>
141
141
  │ ├── watch <run-id>
142
142
  │ └── cancel <run-id>
143
+ ├── docs
144
+ │ ├── list|ls [prefix]
145
+ │ ├── search <query>
146
+ │ └── read <topic>
143
147
  └── skill
144
148
  ├── install
145
149
  ├── uninstall [toolIds...]