neex 0.4.3 → 0.4.6

package/README.md

@@ -6,14 +6,14 @@
 </picture>
 </a>
 
-# Neex v0.4.1
+# Neex v0.1.2
+
 ### 🚀 Neex: The Modern Build System for Polyrepo-in-Monorepo Architecture
 
 [![NPM version](https://img.shields.io/npm/v/neex.svg?style=for-the-badge&labelColor=000000&color=0066FF&borderRadius=8)](https://www.npmjs.com/package/neex)
 [![Download Count](https://img.shields.io/npm/dt/neex.svg?style=for-the-badge&labelColor=000000&color=0066FF&borderRadius=8)](https://www.npmjs.com/package/neex)
 [![MIT License](https://img.shields.io/badge/license-MIT-0066FF.svg?style=for-the-badge&labelColor=000000&borderRadius=8)](https://github.com/neexjs/blob/main/LICENSE)
 [![GitHub](https://img.shields.io/badge/GitHub-Neex-0066FF.svg?style=for-the-badge&logo=github&labelColor=000000&logoWidth=20&borderRadius=8)](https://github.com/Neexjs)
-
 </div>
 
 ## 🎯 Overview
@@ -25,7 +25,7 @@ Neex is a modern build system designed to bridge the gap between polyrepo and mo
 ## ✨ Key Features
 
 - 🎨 **Colored Output** - Distinguish commands with unique colors
-- ⚡ **Dual Execution Modes** - Run commands in parallel (`p`) or sequence (`s`)
+- ⚡ **Dual Execution Modes** - Run commands in parallel (`p`, `runx`) or sequence (`s`, `run`)
 - ⏱️ **Smart Timing** - Track execution time for each command
 - 🛑 **Error Control** - Stop on first error (perfect for CI/CD)
 - 🔢 **Parallel Control** - Limit concurrent processes with `--max-parallel`
@@ -49,45 +49,22 @@ bun add -D neex  # bun
 
 ## 🖥️ Usage
 
-### Process Management Commands
+### Commands
 
-```bash
-# Start a process
-neex startx app.js -n "my-app" -w
-
-# startx options
--n, --name <name>           Process name
--w, --watch                 Watch for file changes
--r, --max-restarts <number> Maximum restart attempts
--d, --restart-delay <ms>    Delay between restarts
-
-# Stop a process
-neex stopx <process-id>
-
-# List processes
-neex list
-neex list -a               # Show all processes
-neex list -j               # JSON output
-
-# Monitor process
-neex monit <process-id>
-neex monit <process-id> -i 1000  # Set update interval
-
-# View logs
-neex log <process-id>
-neex log <process-id> -f   # Follow logs
-neex log <process-id> -e   # Show only errors
-neex log <process-id> -w   # Show only warnings
-```
+- `runx` (alias: `p`) - Run in **parallel** (default)
+- `run` (alias: `s`) - Run **sequentially**
 
-### Script Execution Commands
+### Examples
 
 ```bash
+# Parallel execution (default)
+neex p "echo Task 1" "echo Task 2" "echo Task 3"
+
 # Sequential execution
-neex s "npm install" "npm run build"
+neex s "echo Step 1" "echo Step 2" "echo Step 3"
 
-# Parallel execution
-neex p "npm run dev" "npm run watch"
+# Parallel with sequential flag
+neex p -q "echo Step 1" "echo Step 2" "echo Step 3"
 ```
 
 ### 🛠️ Options
@@ -102,6 +79,14 @@ neex p "npm run dev" "npm run watch"
 | `--max-parallel` | `-m` | Max parallel tasks | CPU count |
 | `--sequential` | `-q` | Force sequential | `false` |
 
+
+### Advanced Example
+
+```bash
+# Run tests & build with max 2 parallel tasks, stop on error
+neex p -s -m 2 -t "npm test" "npm run build" "npm run lint"
+```
+
 ## 📦 Node.js API
 
 ```javascript
@@ -130,6 +115,20 @@ async function main() {
 }
 ```
 
+### API Options
+
+```typescript
+interface RunOptions {
+  parallel?: boolean;     // Run in parallel (default: true)
+  maxParallel?: number;  // Max parallel processes (default: CPU count)
+  color?: boolean;       // Enable colors (default: true)
+  prefix?: boolean;      // Show command prefix (default: true)
+  showTiming?: boolean;  // Show timing info (default: true)
+  printOutput?: boolean; // Show command output (default: true)
+  stopOnError?: boolean; // Stop on failure (default: false)
+}
+```
+
 ## 🔄 CI/CD Integration
 
 ```yaml
@@ -144,45 +143,16 @@ steps:
 
 ## 💡 Real-world Examples
 
-### Multi-part Project Execution
-
-```json
-{
-  "scripts": {
-    "dev": "neex p dev:client dev:server",
-    "dev:client": "cd apps/client && npm run dev",
-    "dev:server": "cd apps/server && npm run dev",
-    "build": "neex s build:client build:server",
-    "build:client": "cd apps/client && npm run build",
-    "build:server": "cd apps/server && npm run build",
-    "start": "neex p start:client start:server",
-    "start:client": "cd apps/client && npm run start",
-    "start:server": "cd apps/server && npm run start"
-  }
-}
-```
-
-### Production Project Management
-
-```json
-{
-  "scripts": {
-    "startx": "neex startx:client && neex startx:server",
-    "startx:client": "neex startx apps/client/index.js -n client -w",
-    "startx:server": "neex startx apps/server/index.js -n server -w",
-    "stopx": "neex stopx:client && neex stopx:server",
-    "stopx:client": "neex stopx client",
-    "stopx:server": "neex stopx server"
-  }
-}
-```
+```bash
+# Dev servers
+neex p "cd frontend && npm dev" "cd api && npm dev"
 
-## Important Notes
+# Monorepo build
+neex p -m 2 "npm run build:ui" "npm run build:api"
 
-- Logs are stored in the `.neex-logs` directory
-- Configuration is stored in `.neex-config.json`
-- Use `Ctrl+C` to stop live monitoring
-- Use `neex stopx -f` for force stop when needed
+# Deploy pipeline
+neex s -s "npm test" "npm run build" "npm run deploy"
+```
 
 ## 🤝 Contributing