@eigenpal/cli 0.12.1 → 0.13.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 (6) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/cli.js +2282 -2520
  3. package/dist/skill/SKILL.md +7 -0
  4. package/dist/skill/reference/cli/surface.md +2 -0
  5. package/dist/skill/reference/cli/workflow.md +58 -12
  6. package/package.json +1 -1
package/dist/skill/SKILL.md CHANGED
@@ -80,6 +80,13 @@ eigenpal workflow evaluators push <workflow-id> --file ./evaluators.yaml
80
80
  eigenpal workflow experiment run <workflow-id>
81
81
  eigenpal workflow experiment watch <workflow-id> <batch-id>
82
82
  eigenpal workflow experiment results <workflow-id> <batch-id> --format csv --out results.csv
83
+
84
+ # Create a tagged candidate without moving live traffic, then promote it.
85
+ eigenpal workflow versions create <workflow-id> --file workflow.yaml --set-version 1.4.0 --no-activate
86
+ eigenpal workflow versions list <workflow-id>
87
+ eigenpal workflow versions promote <workflow-id> <version-id>
88
+ # Restore copies a snapshot into a new untagged current HEAD.
89
+ eigenpal workflow versions restore <workflow-id> <version-id>
83
90
  ```
84
91
 
85
92
  Folders are server metadata, not `workflow.yaml` content:
package/dist/skill/reference/cli/surface.md CHANGED
@@ -42,6 +42,8 @@ eigenpal
42
42
  │ │ └── watch <workflow-id> <batchId>
43
43
  │ ├── versions
44
44
  │ │ ├── list|ls <workflow-id>
45
+ │ │ ├── create <workflow-id>
46
+ │ │ ├── promote <workflow-id> <versionId>
45
47
  │ │ └── restore <workflow-id> <versionId>
46
48
  │ ├── step-type
47
49
  │ │ ├── list|ls
package/dist/skill/reference/cli/workflow.md CHANGED
@@ -41,6 +41,8 @@ Manage workflows: push, pull, and evaluate.
41
41
  - [`eigenpal workflow experiment|exp compare|diff [options] <batchIdA> <batchIdB>`](#eigenpal-workflow-experimentexp-comparediff-options-batchida-batchidb)
42
42
  - [`eigenpal workflow experiment|exp watch [options] <workflow-id> <batchId>`](#eigenpal-workflow-experimentexp-watch-options-workflow-id-batchid)
43
43
  - [`eigenpal workflow versions list|ls [options] <workflow-id>`](#eigenpal-workflow-versions-listls-options-workflow-id)
44
+ - [`eigenpal workflow versions create [options] <workflow-id>`](#eigenpal-workflow-versions-create-options-workflow-id)
45
+ - [`eigenpal workflow versions promote [options] <workflow-id> <versionId>`](#eigenpal-workflow-versions-promote-options-workflow-id-versionid)
44
46
  - [`eigenpal workflow versions restore [options] <workflow-id> <versionId>`](#eigenpal-workflow-versions-restore-options-workflow-id-versionid)
45
47
  - [`eigenpal workflow step-type list|ls [options]`](#eigenpal-workflow-step-type-listls-options)
46
48
  - [`eigenpal workflow step-type get [options] <type>`](#eigenpal-workflow-step-type-get-options-type)
@@ -81,6 +83,8 @@ workflow
81
83
  │ └── watch <workflow-id> <batchId>
82
84
  ├── versions
83
85
  │ ├── list|ls <workflow-id>
86
+ │ ├── create <workflow-id>
87
+ │ ├── promote <workflow-id> <versionId>
84
88
  │ └── restore <workflow-id> <versionId>
85
89
  ├── step-type
86
90
  │ ├── list|ls
@@ -143,10 +147,12 @@ workflow
143
147
 
144
148
  ### Versions
145
149
 
146
- | Command | Description |
147
- | ------------------------------------------------------------------------ | ------------------------------------------------ |
148
- | `eigenpal workflow versions list\|ls [options] <workflow-id>` | List historical workflow versions, newest first. |
149
- | `eigenpal workflow versions restore [options] <workflow-id> <versionId>` | Restore the workflow to a previous version. |
150
+ | Command | Description |
151
+ | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
152
+ | `eigenpal workflow versions list\|ls [options] <workflow-id>` | List tagged workflow versions plus the current untagged snapshot when HEAD is untagged, newest first. |
153
+ | `eigenpal workflow versions create [options] <workflow-id>` | Create a tagged workflow version from YAML or by copying an existing snapshot. |
154
+ | `eigenpal workflow versions promote [options] <workflow-id> <versionId>` | Make an existing tagged workflow version current without creating another snapshot. |
155
+ | `eigenpal workflow versions restore [options] <workflow-id> <versionId>` | Restore a previous snapshot as a new untagged current version. Does not retag the source. |
150
156
 
151
157
  ### Step-type
152
158
 
@@ -629,7 +635,7 @@ Poll until terminal, then auto-pull results — replaces `status --watch` + `res
629
635
 
630
636
  ### `eigenpal workflow versions list|ls [options] <workflow-id>`
631
637
 
632
- List historical workflow versions, newest first.
638
+ List tagged workflow versions plus the current untagged snapshot when HEAD is untagged, newest first.
633
639
 
634
640
  ### Arguments
635
641
 
@@ -639,16 +645,55 @@ List historical workflow versions, newest first.
639
645
 
640
646
  ### Options
641
647
 
648
+ | Flag | Required | Default | Description |
649
+ | ------------------ | -------- | ------- | --------------------------------------------------------------------------------------------- |
650
+ | `--limit <n>` | no | `50` | Page size |
651
+ | `--offset <n>` | no | `0` | Page offset |
652
+ | `--base-url <url>` | no | | Server base URL |
653
+ | `--json` | no | | Print the sliced { data, total, limit, offset } envelope as JSON (not the raw server payload) |
654
+
655
+ ### `eigenpal workflow versions create [options] <workflow-id>`
656
+
657
+ Create a tagged workflow version from YAML or by copying an existing snapshot.
658
+
659
+ ### Arguments
660
+
661
+ | Name | Required | Variadic | Description |
662
+ | ------------- | -------- | -------- | ----------- |
663
+ | `workflow-id` | yes | no | |
664
+
665
+ ### Options
666
+
667
+ | Flag | Required | Default | Description |
668
+ | ------------------------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
669
+ | `--file <yaml>` | no | | Path to workflow YAML. Mutually exclusive with --from. |
670
+ | `--from <version-id>` | no | | Existing version id to copy into a new tagged snapshot. Leaves the source tag unchanged. Mutually exclusive with --file. |
671
+ | `--set-version <semver>` | no | | Bare semver tag such as 1.4.0. Required when copying with --from. For --file, omit this flag if the YAML already has a top-level version: field. (Named --set-version to avoid the global -v, --version flag.) |
672
+ | `--no-activate` | no | | Keep the tagged version off live traffic until you promote it. Default is to make it current. Requires an existing current version. |
673
+ | `--base-url <url>` | no | | Server base URL |
674
+ | `--json` | no | | Output the raw server response as JSON |
675
+
676
+ ### `eigenpal workflow versions promote [options] <workflow-id> <versionId>`
677
+
678
+ Make an existing tagged workflow version current without creating another snapshot.
679
+
680
+ ### Arguments
681
+
682
+ | Name | Required | Variadic | Description |
683
+ | ------------- | -------- | -------- | ----------- |
684
+ | `workflow-id` | yes | no | |
685
+ | `versionId` | yes | no | |
686
+
687
+ ### Options
688
+
642
689
  | Flag | Required | Default | Description |
643
690
  | ------------------ | -------- | ------- | -------------------------------------- |
644
- | `--limit <n>` | no | `50` | Page size |
645
- | `--offset <n>` | no | `0` | Page offset |
646
691
  | `--base-url <url>` | no | | Server base URL |
647
692
  | `--json` | no | | Output the raw server response as JSON |
648
693
 
649
694
  ### `eigenpal workflow versions restore [options] <workflow-id> <versionId>`
650
695
 
651
- Restore the workflow to a previous version.
696
+ Restore a previous snapshot as a new untagged current version. Does not retag the source.
652
697
 
653
698
  ### Arguments
654
699
 
@@ -659,10 +704,11 @@ Restore the workflow to a previous version.
659
704
 
660
705
  ### Options
661
706
 
662
- | Flag | Required | Default | Description |
663
- | ------------------ | -------- | ------- | -------------------------------------- |
664
- | `--base-url <url>` | no | | Server base URL |
665
- | `--json` | no | | Output the raw server response as JSON |
707
+ | Flag | Required | Default | Description |
708
+ | ------------------ | -------- | ------- | ------------------------------------------------ |
709
+ | `--message <text>` | no | | Optional restore note stored on the new snapshot |
710
+ | `--base-url <url>` | no | | Server base URL |
711
+ | `--json` | no | | Output the raw server response as JSON |
666
712
 
667
713
  ### `eigenpal workflow step-type list|ls [options]`
668
714
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@eigenpal/cli",
3
- "version": "0.12.1",
3
+ "version": "0.13.0",
4
4
  "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
5
5
  "keywords": [
6
6
  "eigenpal",