@onexapis/cli 1.1.16 → 1.1.18

package/README.md

@@ -19,29 +19,38 @@ Requires Node.js >= 18.
 ## Quick Start
 
 ```bash
-# 1. Configure credentials (one-time setup)
-onex config
+# 1. Login to OneX platform
+onexthm login
 
 # 2. Create a new theme project
-onex init my-theme
+onexthm init my-theme
+cd my-theme
 
-# Or clone an existing theme
-onex clone simple
+# 3. Develop with live preview
+onexthm dev
+
+# 4. Publish to marketplace (authenticated, secure)
+onexthm publish
 ```
 
-```bash
-# Other useful commands
-onex list                              # List themes, sections, blocks
-onex create:section hero --theme simple  # Scaffold a section
-onex validate --theme simple           # Validate theme structure
-onex build --theme simple              # Build a theme
-onex upload --theme simple             # Upload to S3
-onex clone simple                      # Clone a theme from S3
+## Theme Developer Flow
+
+```
+onexthm login                  # Authenticate with OneX platform
+onexthm init my-store          # Scaffold theme from template (7 sections, 3 pages)
+cd my-store
+onexthm dev                    # Live preview at localhost:3456
+onexthm create:section pricing # Add new section
+onexthm validate               # Check structure
+onexthm build                  # Compile for production
+onexthm publish                # Register → build → upload → scan → publish
+onexthm whoami                 # Check logged-in status
+onexthm logout                 # End session
 ```
 
 ## Commands
 
-### `onex init [project-name]`
+### `onexthm init [project-name]`
 
 Create a new OneX theme project from a template.
 
@@ -52,7 +61,7 @@ Create a new OneX theme project from a template.
 | `--git`                     | Initialize a git repository            |
 | `-y, --yes`                 | Skip prompts and use defaults          |
 
-### `onex create:section <name>` (alias: `cs`)
+### `onexthm create:section <name>` (alias: `cs`)
 
 Scaffold a new section inside a theme.
 
@@ -63,11 +72,11 @@ Scaffold a new section inside a theme.
 | `--template <template>`     | Initial template variant (`default`, `minimal`)    |
 
 ```bash
-onex create:section hero -t my-theme -c heroes
-onex cs featured-products -t my-store
+onexthm create:section hero -t my-theme -c heroes
+onexthm cs featured-products -t my-store
 ```
 
-### `onex create:block <name>` (alias: `cb`)
+### `onexthm create:block <name>` (alias: `cb`)
 
 Scaffold a new block.
 
@@ -76,11 +85,11 @@ Scaffold a new block.
 | `-t, --theme <theme>` | Target theme (optional) |
 
 ```bash
-onex create:block product-card
-onex cb testimonial-item -t my-theme
+onexthm create:block product-card
+onexthm cb testimonial-item -t my-theme
 ```
 
-### `onex create:component <name>` (alias: `cc`)
+### `onexthm create:component <name>` (alias: `cc`)
 
 Scaffold a new UI component.
 
@@ -89,11 +98,11 @@ Scaffold a new UI component.
 | `-t, --type <type>` | Component type (`ui`, `layout`, `form`) |
 
 ```bash
-onex create:component icon-badge
-onex cc custom-input -t form
+onexthm create:component icon-badge
+onexthm cc custom-input -t form
 ```
 
-### `onex list`
+### `onexthm list`
 
 List available themes, sections, blocks, and components in the project.
 
@@ -104,7 +113,7 @@ List available themes, sections, blocks, and components in the project.
 | `-c, --components`    | List components only |
 | `-t, --theme <theme>` | Filter by theme      |
 
-### `onex validate`
+### `onexthm validate`
 
 Validate theme structure and files.
 
@@ -113,7 +122,7 @@ Validate theme structure and files.
 | `-t, --theme <theme>` | Theme to validate                     |
 | `-f, --fix`           | Auto-fix issues (not yet implemented) |
 
-### `onex build`
+### `onexthm build`
 
 Build a theme for production. Runs type-check, lint, and compilation.
 
@@ -129,7 +138,7 @@ Build a theme for production. Runs type-check, lint, and compilation.
 > { "scripts": { "type-check": "tsc --noEmit", "lint": "eslint src" } }
 > ```
 
-### `onex package`
+### `onexthm package`
 
 Compile and package a theme as a distributable zip file.
 
@@ -141,7 +150,7 @@ Compile and package a theme as a distributable zip file.
 | `-m, --minify`        | Minify compiled output                        |
 | `--skip-build`        | Skip compilation, use existing compiled theme |
 
-### `onex deploy`
+### `onexthm deploy`
 
 Upload a theme package to the API server.
 
@@ -153,7 +162,7 @@ Upload a theme package to the API server.
 | `-k, --api-key <key>`     | API key for authentication                           |
 | `-e, --environment <env>` | Environment (`production`, `staging`, `development`) |
 
-### `onex upload`
+### `onexthm upload`
 
 Upload compiled theme to S3 as `bundle.zip` + `source.zip`.
 
@@ -169,19 +178,19 @@ Upload compiled theme to S3 as `bundle.zip` + `source.zip`.
 
 ```bash
 # Dry run first
-onex upload --theme simple --dry-run
+onexthm upload --theme simple --dry-run
 
 # Upload to staging
-onex upload --theme simple
+onexthm upload --theme simple
 
 # Upload to production
-onex upload --theme simple -e production
+onexthm upload --theme simple -e production
 
 # Override bucket
-onex upload --theme simple --bucket custom-bucket
+onexthm upload --theme simple --bucket custom-bucket
 ```
 
-### `onex download`
+### `onexthm download`
 
 Download a compiled theme from S3.
 
@@ -193,7 +202,7 @@ Download a compiled theme from S3.
 | `-e, --environment <env>` | Environment (`staging` or `production`)      |
 | `-o, --output <dir>`      | Output directory (default: `./active-theme`) |
 
-### `onex clone <theme-name>`
+### `onexthm clone <theme-name>`
 
 Clone theme source code from S3.
 
@@ -207,20 +216,77 @@ Clone theme source code from S3.
 | `--no-install`            | Skip running `pnpm install` after clone   |
 
 ```bash
-onex clone simple
-onex clone simple -n my-store
-onex clone simple -v 1.0.0 -o ./my-clone --no-install
+onexthm clone simple
+onexthm clone simple -n my-store
+onexthm clone simple -v 1.0.0 -o ./my-clone --no-install
+```
+
+### `onexthm login`
+
+Authenticate with the OneX platform. Stores encrypted JWT token in `~/.onexthm/auth.json`.
+
+```bash
+onexthm login
+# Email: dev@example.com
+# Password: ********
+# ✓ Logged in! Token stored securely.
 ```
 
-### `onex config`
+Required before `onexthm publish`. Token auto-refreshes on expiry.
 
-Interactive setup for CLI credentials. Saves configuration to `~/.onex/.env` so S3 commands (`clone`, `upload`, `download`) work from any directory.
+### `onexthm logout`
+
+Clear stored authentication tokens.
 
 ```bash
-onex config
+onexthm logout
 ```
 
-Prompts for:
+### `onexthm whoami`
+
+Show current logged-in developer info.
+
+```bash
+onexthm whoami
+# Email: dev@example.com
+# Company: 9e61d187-...
+# Status: ✓ Active
+```
+
+### `onexthm publish`
+
+Build, scan, and publish theme to the marketplace. Requires login.
+
+```bash
+onexthm publish
+# ✓ Logged in as dev@example.com
+# Publishing my-store v1.0.0...
+#   1. Registering theme...     ✓
+#   2. Building...              ✓ (54 KB)
+#   3. Getting upload URL...    ✓
+#   4. Uploading bundle...      ✓
+#   5. Uploading source...      ✓
+#   6. Scanning & publishing... ✓ Published!
+```
+
+| Option               | Description          |
+| -------------------- | -------------------- |
+| `-t, --theme <path>` | Theme directory path |
+
+Security features:
+
+- **Ownership check** — only theme owner can publish updates
+- **Presigned URLs** — no AWS credentials needed
+- **Security scan** — blocks eval(), XSS, crypto mining, data exfiltration
+- **Audit logging** — every publish is logged with developer identity
+
+### `onexthm config` (Legacy)
+
+Interactive setup for S3 credentials. **Not needed for `onexthm publish`** — use `onexthm login` instead.
+
+```bash
+onexthm config
+```
 
 | Key                      | Description           | Required |
 | ------------------------ | --------------------- | -------- |
@@ -237,19 +303,19 @@ Run this once after installing the CLI. Re-run anytime to update values.
 
 The `upload`, `download`, and `clone` commands use S3 for storage.
 
-### Recommended: use `onex config`
+### Recommended: use `onexthm config`
 
 ```bash
-# One-time setup — saves credentials to ~/.onex/.env
-onex config
+# One-time setup — saves credentials to ~/.onexthm/.env
+onexthm config
 ```
 
-After running `onex config`, all S3 commands work from any directory:
+After running `onexthm config`, all S3 commands work from any directory:
 
 ```bash
-onex clone simple             # works anywhere
-onex upload --theme simple    # picks up config automatically
-onex download -t simple       # same
+onexthm clone simple             # works anywhere
+onexthm upload --theme simple    # picks up config automatically
+onexthm download -t simple       # same
 ```
 
 ### Manual configuration
@@ -257,7 +323,7 @@ onex download -t simple       # same
 The CLI loads env files in this order (first found wins):
 
 1. **Project-level**: `.env.local` and `.env` at the project root
-2. **Global**: `~/.onex/.env` (set by `onex config`, or create manually)
+2. **Global**: `~/.onexthm/.env` (set by `onexthm config`, or create manually)
 
 ### Adapter Modes
 
@@ -334,7 +400,7 @@ packages/cli/
 │       ├── file-helpers.ts     # File operations & project detection
 │       └── validators.ts       # Input validation
 ├── bin/
-│   └── onex.js                 # Executable entry point
+│   └── onexthm.js                 # Executable entry point
 ├── templates/                  # Scaffolding templates
 └── package.json
 ```

package/bin/onexthm.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// Load the compiled CLI
+require("../dist/cli.js");