@fastino-ai/pioneer-cli 0.2.9 → 0.2.11

package/README.md

@@ -59,26 +59,37 @@ pioneer agent --mode research                       # Research mode (Pro subscri
 pioneer job list
 pioneer job get <id>
 pioneer job logs <id>
-pioneer job create --model-name "My Model" --dataset-ids ds_123,ds_456
+pioneer job delete <id>
+# To create a training job, use the agent — it will help you pick a base model
+# and datasets conversationally:
+pioneer agent
 
 # Models
-pioneer model endpoints list                          # List model catalog entries (/projects)
+pioneer model base-models                             # List available base models (tabular)
+pioneer model endpoints list                          # List model catalog entries
 pioneer model endpoints create                        # Create a model entry (interactive by default)
 pioneer model endpoints create --model "qwen/Qwen3-8B-Instruct" --repo https://github.com/fastino-ai/Pioneer
-pioneer model endpoints get <model-id>
+pioneer model endpoints get <model-id>                # Endpoint details (incl. attached dataset count)
 pioneer model endpoints update <model-id> --description "Updated model metadata"
 pioneer model endpoints delete <model-id>
-pioneer model endpoints dataset-count <model-id>
 pioneer model endpoints quality-metrics <model-id>
-pioneer model endpoints deploy <model-id> --job <training-job-id> [--reason "..." ]
+pioneer model endpoints deploy <model-id> [--job <training-job-id>] [--reason "..." ] [--all]
+                                                       # If --job is omitted, pick from a list of deployable jobs interactively.
+                                                       # The list is filtered to jobs whose base model matches the endpoint; pass --all to bypass that filter.
 pioneer model endpoints rollback <model-id> <deployment-id>
 
 pioneer model artifacts list                          # List trained and deployed artifacts
 pioneer model artifacts trained                       # List trained artifacts
 pioneer model artifacts deployed                      # List deployed artifacts
-pioneer model artifacts download <job-id>
+pioneer model artifacts download <job-id>             # Get a signed download URL for the artifact
 pioneer model artifacts upload <job-id> --to hf --repo username/model  # Push trained artifact to HF
 
+# Datasets
+pioneer dataset list                                  # List remote + local datasets (tabular)
+pioneer dataset get <name[:version]>                  # Dataset details (key/value layout)
+
+# Most read commands also accept --json for the raw JSON payload.
+
 # Aliases
 pioneer model_endpoints list
 pioneer model_artifacts list
@@ -113,6 +124,8 @@ pioneer agent resume 4f2a...
 
 When you start any of these commands, the CLI opens a conversational prompt and keeps accepting follow-up messages in the same session.
 
+Interactive **standard** mode uses the same WebSocket agent as the Pioneer app’s sidebar: Felix tools plus **local** CLI tools (**bash**, **read_file**, **write_file**, **edit_file**, **list_directory**, **search_files**, and **`browse_url`** — HTTP GET for public pages with HTML stripped; no JavaScript). Full **Browser Use** (driving your open Pioneer UI with click/type/navigate against the live DOM) remains **web-only**; the CLI surfaces a clear hint if those tools appear.
+
 ## End-to-End Example
 
 This example shows the complete workflow from running jobs to using agent support.
@@ -129,14 +142,12 @@ pioneer agent
 
 ### Step 3: Create a Training Job
 
-Start training with one or more datasets:
+Use `pioneer agent` to create a training job. The agent will guide you through
+picking a base model, selecting datasets, and configuring hyperparameters
+without needing to remember flags or dataset IDs:
 
 ```bash
-pioneer job create \
-  --model-name "Medical NER Model v1" \
-  --dataset-ids "<dataset-id>" \
-  --base-model "fastino/gliner2-base-v1" \
-  --epochs 10
+pioneer agent
 ```
 
 ### Step 4: Monitor Training Progress
@@ -227,6 +238,32 @@ bun run dev          # Hot reload
 bun run typecheck    # Type checking
 ```
 
+### Release
+
+Before publishing, bump `package.json` to a version that is not already on npm:
+
+```bash
+npm version patch --no-git-tag-version
+```
+
+Then verify the npm package tarball locally:
+
+```bash
+bun run release:check-version
+bun run release:pack
+```
+
+`release:pack` writes the verified package to `release-artifacts/*.tgz` and checks that the tarball contains only:
+
+```text
+README.md
+dist/index.js
+dist/yoga.wasm
+package.json
+```
+
+To publish, run the **Publish Pioneer CLI npm Package** GitHub Actions workflow from `main`. Leave `dry_run=true` to build and upload the tarball as a GitHub Actions artifact without publishing. Set `dry_run=false` to publish the verified tarball to npm and attach the same `.tgz` to a `vX.Y.Z` GitHub Release.
+
 ## Tech Stack
 
 - **Runtime**: [Bun](https://bun.sh)