@fastino-ai/pioneer-cli 0.2.7 → 0.2.9

package/README.md

@@ -51,15 +51,9 @@ pioneer auth login       # Enter API key interactively
 pioneer auth logout      # Clear stored API key
 pioneer auth status      # Check if logged in
 
-# Chat (interactive agent)
-pioneer chat             # Start chat with AI agent
-
-# Datasets
-pioneer dataset list
-pioneer dataset get <id>
-pioneer dataset delete <id>
-pioneer dataset download <id>
-pioneer dataset analyze <id>
+# Agent
+pioneer agent                                      # Interactive chat (default)
+pioneer agent --mode research                       # Research mode (Pro subscription required)
 
 # Training Jobs
 pioneer job list
@@ -68,58 +62,69 @@ pioneer job logs <id>
 pioneer job create --model-name "My Model" --dataset-ids ds_123,ds_456
 
 # Models
-pioneer model list       # List deployed models
-pioneer model trained    # List trained models
-pioneer model delete <id>
-pioneer model download <id>
-```
+pioneer model endpoints list                          # List model catalog entries (/projects)
+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 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 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 upload <job-id> --to hf --repo username/model  # Push trained artifact to HF
+
+# Aliases
+pioneer model_endpoints list
+pioneer model_artifacts list
+```
+
+## Agent command
+
+`agent` starts in interactive mode by default (standard workflow). For the only explicit alternate mode:
+- `--mode research`: Pro mode with deeper research response style.
+- `agent resume`: list recent conversations and resume a selected session.
+- `agent sessions`: explicit alias for listing sessions and resuming one.
 
-## End-to-End Example
+```bash
+# Interactive (default)
+pioneer agent
 
-This example shows the complete workflow from generating a dataset to training a model.
+# Standard mode is the default:
+pioneer agent
 
-### Step 1: Generate a Dataset
+# Research mode (Pro subscription required)
+pioneer agent --mode research
 
-Generate a NER (Named Entity Recognition) dataset for medical text:
+# Open a session list and pick one to continue
+pioneer agent resume
 
-```bash
-# Save locally to ./datasets/ (default)
-pioneer dataset generate ner \
-  --labels "DISEASE,SYMPTOM,TREATMENT,MEDICATION" \
-  --num 50 \
-  --domain "Medical clinical notes and patient records" \
-  --name "medical-ner"
-
-# Or save to remote database
-pioneer dataset generate ner \
-  --labels "DISEASE,SYMPTOM,TREATMENT,MEDICATION" \
-  --num 50 \
-  --domain "Medical clinical notes and patient records" \
-  --save true \
-  --name "Medical NER Dataset"
+# Equivalent: explicit sessions command
+pioneer agent sessions
+
+# Resume a specific conversation id
+pioneer agent resume 4f2a...
 ```
 
-Or generate a classification dataset for sentiment analysis:
+When you start any of these commands, the CLI opens a conversational prompt and keeps accepting follow-up messages in the same session.
 
-```bash
-pioneer dataset generate classification \
-  --labels "positive,negative,neutral" \
-  --num 200 \
-  --domain "Customer product reviews" \
-  --name "sentiment"
-```
+## End-to-End Example
 
-### Step 2: View Your Datasets
+This example shows the complete workflow from running jobs to using agent support.
 
-```bash
-# List all datasets (both remote and local ./datasets/*.json)
-pioneer dataset list
+### Step 1: Start a planning session
+Use `agent` for quick iteration while preparing jobs and reviewing results.
 
-# Get details for a remote dataset
-pioneer dataset get <dataset-id>
+### Step 2: Open the interactive helper
 
-# Analyze dataset statistics
-pioneer dataset analyze <dataset-id>
+```bash
+# Open a short interactive helper session
+pioneer agent
 ```
 
 ### Step 3: Create a Training Job
@@ -153,10 +158,10 @@ Once training completes:
 
 ```bash
 # List trained models
-pioneer model list trained
+pioneer model artifacts trained
 
 # Download the trained model
-pioneer model download <job-id>
+pioneer model artifacts download <job-id>
 ```
 
 ## Configuration
@@ -178,7 +183,10 @@ The CLI stores your API key in `~/.pioneer/config.json` after running `pioneer a
 
 ### Pioneer API
 
-To use the CLI, you'll need a Pioneer API key. Get one at https://app.pioneer.ai/api-keys .
+To use the CLI, you'll need a Pioneer API key. Get one at https://app.pioneer.ai/api-keys.
+
+By default, the CLI points at production (`https://api.pioneer.ai`).
+For dev/staging and local debugging, set `PIONEER_API_URL` explicitly (for example: `https://api-dev.pioneer.ai` or `http://localhost:5001`).
 
 ```bash
 # Login with your API key
@@ -193,7 +201,7 @@ pioneer auth logout
 
 ### Hugging Face (Optional)
 
-For pushing/pulling datasets and models to/from Hugging Face, you'll need an HF token. Get one at https://huggingface.co/settings/tokens .
+For uploading model artifacts to Hugging Face, you'll need an HF token. Get one at https://huggingface.co/settings/tokens .
 
 ```bash
 # Set your Hugging Face token
@@ -206,6 +214,8 @@ pioneer auth hf status
 pioneer auth hf logout
 ```
 
+Note: Hugging Face-backed dataset import/export is currently behind the hidden dataset workflow, so the main recommended HF flow today is model artifact upload via `model artifacts upload --to hf`.
+
 ## Development & Testing
 
 ### Building & Running
@@ -217,25 +227,6 @@ bun run dev          # Hot reload
 bun run typecheck    # Type checking
 ```
 
-### Internal Testing Environment Variables
-
-For Pioneer team members testing against local or staging environments:
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `PIONEER_API_URL` | Override API base URL | `http://localhost:5001` |
-| `PIONEER_API_KEY` | Override saved API key | `your-test-key` |
-| `HF_TOKEN` | Override saved HF token | `your-hf-token` |
-
-```bash
-# Example: Test against local backend
-export PIONEER_API_URL=http://localhost:5001
-export PIONEER_API_KEY=your-local-test-key
-pioneer dataset list
-```
-
-> **Note:** External users should never need to set these variables. The CLI defaults to production (`https://api.pioneer.ai`) and uses `pioneer auth login` for authentication.
-
 ## Tech Stack
 
 - **Runtime**: [Bun](https://bun.sh)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastino-ai/pioneer-cli",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Pioneer CLI - AI training platform with chat agent",
   "type": "module",
   "files": [
@@ -36,6 +36,7 @@
     "@types/react": "^18.3.0",
     "@types/ws": "^8.18.1",
     "bun-types": "^1.1.0",
+    "ink-testing-library": "^4.0.0",
     "typescript": "^5.6.3"
   },
   "engines": {