neex 0.1.5 → 0.1.6

package/README.md

@@ -6,7 +6,7 @@
 </picture>
 </a>
 
-# Neex v0.1.5
+# Neex v0.1.6
 
 ### 🚀 Neex: The Modern Build System for Polyrepo-in-Monorepo Architecture
 
@@ -25,7 +25,7 @@ Neex is a modern build system and script runner designed for **Polyrepo-in-Monor
 ## ✨ Key Features
 
 - 🎨 **Colored Output** - Distinguish commands with unique colors
-- ⚡ **Dual Execution Modes** - Run commands in parallel (`p`, `runx`) or sequence (`s`, `run`)
+- ⚡ **Dual Execution Modes** - Run commands in parallel (`px`) 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`
@@ -70,7 +70,7 @@ bun add -D neex  # bun
 
 Neex provides several commands to manage and run your scripts:
 
-- **`runx <commands...>`** (alias: `px`, *default command*)
+- **`px <commands...>`** (*default command*)
   - Runs specified commands in **parallel** by default.
   - Use the `-q` or `--sequential` flag to run them sequentially.
   - Ideal for build steps, tests, or any tasks that can run concurrently.
@@ -105,9 +105,9 @@ Neex provides several commands to manage and run your scripts:
 ### General Command Examples
 
 ```bash
-# Parallel execution (default behavior for runx)
-neex runx "npm run build:api" "npm run build:frontend" "npm run lint"
-# Alias for parallel
+# Parallel execution (default behavior for px)
+neex px "npm run build:api" "npm run build:frontend" "npm run lint"
+# px is the command for parallel execution
 neex px "npm run test:unit" "npm run test:integration"
 
 # Sequential execution
@@ -115,8 +115,8 @@ neex run "npm run clean" "npm run build" "npm run deploy"
 # Alias for sequential
 neex s "echo First" "echo Second" "echo Third"
 
-# Run 'runx' commands sequentially using the -q flag
-neex runx -q "npm run step1" "npm run step2"
+# Run 'px' commands sequentially using the -q flag
+neex px -q "npm run step1" "npm run step2"
 ```
 
 ### `servers` Command Examples
@@ -167,9 +167,9 @@ neex restart my-app
 neex delete my-api
 ```
 
-### 🛠️ Global Options (for `run`, `runx`, `servers`)
+### 🛠️ Global Options (for `run`, `px`, `servers`)
 
-These options can be used with `run`, `runx`, and `servers` commands:
+These options can be used with `run`, `px`, and `servers` commands:
 
 | Flag                     | Alias | Description                                       | Default        |
 |--------------------------|-------|---------------------------------------------------|----------------|
@@ -180,7 +180,7 @@ These options can be used with `run`, `runx`, and `servers` commands:
 | `--no-output`            | `-o`  | Hide all `stdout` and `stderr` from commands      | `true` (output on) |
 | `--minimal`              |       | Use minimal output format (less verbose)          | `false`        |
 | `--max-parallel <number>`|       | Maximum number of commands to run in parallel     | CPU count      |
-| `--sequential`           | `-q`  | (For `runx`) Run commands sequentially instead of parallel | `false`        |
+| `--sequential`           | `-q`  | (For `px`) Run commands sequentially instead of parallel | `false`        |
 | `--retry <count>`        |       | Number of times to retry a failed command         | `0`            |
 | `--retry-delay <ms>`     |       | Delay in milliseconds between retries             | `1000`         |
 | `--group-output`         | `-g`  | (For `servers`) Group output by server            | `false`        |

package/dist/src/cli.js

@@ -34,7 +34,49 @@ const process_manager_js_1 = require("./process-manager.js");
 const chalk_1 = __importDefault(require("chalk"));
 const figures_1 = __importDefault(require("figures"));
 const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises")); // Added for reading package.json
 const { version } = require('../../package.json');
+// Helper function to find default command from package.json
+async function findDefaultCommand() {
+    var _a, _b;
+    try {
+        const packageJsonPath = path.join(process.cwd(), 'package.json');
+        await fs.access(packageJsonPath);
+        const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(packageJsonContent);
+        if ((_a = packageJson.scripts) === null || _a === void 0 ? void 0 : _a.dev) {
+            console.log(chalk_1.default.blue(`${figures_1.default.info} No command provided. Using "dev" script from package.json: npm run dev`));
+            return 'npm run dev';
+        }
+        if ((_b = packageJson.scripts) === null || _b === void 0 ? void 0 : _b.start) {
+            console.log(chalk_1.default.blue(`${figures_1.default.info} No command provided. Using "start" script from package.json: npm run start`));
+            return 'npm run start';
+        }
+        if (packageJson.main) {
+            const mainFile = packageJson.main;
+            const mainFilePath = path.resolve(process.cwd(), mainFile);
+            try {
+                await fs.access(mainFilePath);
+                if (mainFile.endsWith('.ts') || mainFile.endsWith('.mts') || mainFile.endsWith('.cts')) {
+                    console.log(chalk_1.default.blue(`${figures_1.default.info} No command or script found. Using "main" field (TypeScript): npx ts-node ${mainFile}`));
+                    return `npx ts-node ${mainFile}`;
+                }
+                else {
+                    console.log(chalk_1.default.blue(`${figures_1.default.info} No command or script found. Using "main" field (JavaScript): node ${mainFile}`));
+                    return `node ${mainFile}`;
+                }
+            }
+            catch (e) {
+                // Main file doesn't exist, do nothing, will fall through to return null
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        // package.json doesn't exist or other error, do nothing
+        return null;
+    }
+}
 function cli() {
     const program = new commander_1.Command();
     let cleanupRunner = null;
@@ -80,9 +122,8 @@ function cli() {
     });
     // runx command: parallel execution by default (with alias 'p'), can run sequentially with -q
     program
-        .command('runx <commands...>', { isDefault: true })
-        .alias('px')
-        .description('Run commands in parallel (default) or sequentially with -q. Alias: px')
+        .command('px <commands...>', { isDefault: true })
+        .description('Run commands in parallel (default) or sequentially with -q. This is the default command.')
         .option('-c, --no-color', 'Disable colored output')
         .option('-t, --no-timing', 'Hide timing information')
         .option('-p, --no-prefix', 'Hide command prefix')
@@ -158,7 +199,7 @@ function cli() {
     });
     // Watch command (Nodemon functionality)
     program
-        .command('watch <commands...>')
+        .command('watch [commands...]') // Made commands optional
         .alias('w')
         .description('Run commands with file watching (nodemon functionality)')
         .option('-c, --no-color', 'Disable colored output')
@@ -176,21 +217,66 @@ function cli() {
         .option('--signal <signal>', 'Signal to send to processes on restart', 'SIGTERM')
         .action(async (commands, options) => {
         try {
-            console.log(chalk_1.default.blue(`${figures_1.default.info} Starting development server with file watching...`));
+            let effectiveCommands = commands;
+            if (!effectiveCommands || effectiveCommands.length === 0) {
+                const foundCommand = await findDefaultCommand();
+                if (foundCommand) {
+                    effectiveCommands = [foundCommand];
+                    console.log(chalk_1.default.blue(`${figures_1.default.info} No command specified for 'neex w', using default: "${foundCommand}"`));
+                }
+                else {
+                    console.error(chalk_1.default.red(`${figures_1.default.cross} No command specified for 'neex w' and no default script (dev, start) or main file found in package.json.`));
+                    console.error(chalk_1.default.yellow(`${figures_1.default.pointer} Please specify a command to run (e.g., neex w "npm run dev") or define a "dev" or "start" script in your package.json.`));
+                    process.exit(1);
+                }
+            }
+            else { // At least one command/argument is provided
+                const firstArg = effectiveCommands[0];
+                const remainingArgs = effectiveCommands.slice(1);
+                const isLikelyCommandOrScript = firstArg.includes(' ') || firstArg.startsWith('npm') || firstArg.startsWith('yarn') || firstArg.startsWith('pnpm');
+                if (!isLikelyCommandOrScript) {
+                    const filePath = path.resolve(process.cwd(), firstArg);
+                    try {
+                        await fs.access(filePath); // Check if file exists
+                        let commandToExecute = '';
+                        if (firstArg.endsWith('.js') || firstArg.endsWith('.mjs') || firstArg.endsWith('.cjs')) {
+                            commandToExecute = `node ${firstArg}`;
+                            console.log(chalk_1.default.blue(`${figures_1.default.info} Detected .js file, prepending with node.`));
+                        }
+                        else if (firstArg.endsWith('.ts') || firstArg.endsWith('.mts') || firstArg.endsWith('.cts')) {
+                            commandToExecute = `npx ts-node ${firstArg}`;
+                            console.log(chalk_1.default.blue(`${figures_1.default.info} Detected .ts file, prepending with npx ts-node.`));
+                        }
+                        if (commandToExecute) {
+                            effectiveCommands = [commandToExecute, ...remainingArgs];
+                            console.log(chalk_1.default.cyan(`${figures_1.default.pointer} Executing: ${effectiveCommands.join(' ')}`));
+                        }
+                        else {
+                            // Not a .js or .ts file, or file doesn't exist but doesn't look like a command either.
+                            // We'll let it try to run as is. If it was meant to be a file, it will likely fail.
+                            // If it was a command like 'echo', it will run.
+                            console.log(chalk_1.default.yellow(`${figures_1.default.warning} First argument "${firstArg}" is not a recognized .js/.ts file and doesn't look like a script. Attempting to run as is.`));
+                        }
+                    }
+                    catch (e) {
+                        // File doesn't exist. Could be a command like 'echo foo' where 'echo' is firstArg.
+                        // Or could be 'my-script --arg' where 'my-script' is not found.
+                        // We'll let it try to run as is. DevRunner will handle if the command is not found.
+                        console.log(chalk_1.default.yellow(`${figures_1.default.warning} File "${firstArg}" not found. Attempting to run as command.`));
+                    }
+                }
+                // If isLikelyCommandOrScript is true, or if the file auto-detection didn't apply,
+                // effectiveCommands remains as the user provided it (joined later by DevRunner).
+            }
+            console.log(chalk_1.default.blue(`${figures_1.default.info} Starting development server with file watching (neex w) for command(s): ${effectiveCommands.map(cmd => `"${cmd}"`).join(' && ')}...`));
             const watchPaths = options.watch || ['./'];
             const ignorePatterns = options.ignore || [
-                'node_modules/**',
-                '.git/**',
-                '*.log',
-                'dist/**',
-                'build/**',
-                'coverage/**',
-                '.nyc_output/**',
-                '*.tmp',
-                '*.temp'
+                'node_modules/**', '.git/**', '*.log', 'dist/**', 'build/**',
+                'coverage/**', '.nyc_output/**', '*.tmp', '*.temp'
             ];
             const extensions = options.ext || ['js', 'mjs', 'json', 'ts', 'tsx', 'jsx'];
             devRunner = new dev_runner_js_1.DevRunner({
+                runnerName: 'neex w',
                 parallel: false,
                 color: options.color,
                 showTiming: options.timing,
@@ -207,9 +293,9 @@ function cli() {
                 signal: options.signal,
                 restartOnChange: true,
                 groupOutput: false,
-                isServerMode: false // Added missing property
+                isServerMode: false
             });
-            await devRunner.start(commands);
+            await devRunner.start(effectiveCommands);
         }
         catch (error) {
             if (error instanceof Error) {

package/dist/src/dev-runner.js

@@ -44,6 +44,7 @@ class DevRunner {
             ext: ['js', 'mjs', 'json', 'ts', 'tsx', 'jsx'],
             delay: 1000,
             verbose: false,
+            runnerName: 'watch', // Default runner name if not specified
         };
         this.options = {
             ...defaultOptions,
@@ -66,7 +67,8 @@ class DevRunner {
         });
     }
     async handleFileChange(event) {
-        logger_1.default.printLine(`File changed: ${chalk_1.default.yellow(event.relativePath)}`, 'info');
+        const prefix = chalk_1.default.cyan(`[${this.options.runnerName}]`);
+        logger_1.default.printLine(`${prefix} File changed: ${chalk_1.default.yellow(event.relativePath)}`, 'info');
         if (this.options.clearConsole) {
             console.clear();
         }
@@ -87,17 +89,18 @@ class DevRunner {
         }
     }
     printDevBanner() {
-        var _a;
+        var _a, _b;
+        const prefix = chalk_1.default.cyan(`[${this.options.runnerName}]`);
         const uptime = Math.floor((Date.now() - this.startTime.getTime()) / 1000);
         const uptimeStr = this.formatUptime(uptime);
-        console.log('\n' + chalk_1.default.bgGreen.black('         DEV MODE         ') + '\n');
+        console.log('\n' + chalk_1.default.bgGreen.black(`    ${(_a = this.options.runnerName) === null || _a === void 0 ? void 0 : _a.toUpperCase()} MODE    `) + '\n');
         if (this.restartCount > 0) {
-            console.log(chalk_1.default.green(`${figures_1.default.arrowUp} Restarted ${this.restartCount} times`));
+            console.log(`${prefix} ${chalk_1.default.green(`${figures_1.default.arrowUp} Restarted ${this.restartCount} times`)}`);
         }
-        console.log(chalk_1.default.blue(`${figures_1.default.info} Uptime: ${uptimeStr}`));
-        console.log(chalk_1.default.blue(`${figures_1.default.info} Watching: ${((_a = this.options.watch) === null || _a === void 0 ? void 0 : _a.join(', ')) || 'current directory'}`));
+        console.log(`${prefix} ${chalk_1.default.blue(`${figures_1.default.info} Uptime: ${uptimeStr}`)}`);
+        console.log(`${prefix} ${chalk_1.default.blue(`${figures_1.default.info} Watching: ${((_b = this.options.watch) === null || _b === void 0 ? void 0 : _b.join(', ')) || 'current directory'}`)}`);
         if (this.options.ext && this.options.ext.length > 0) {
-            console.log(chalk_1.default.blue(`${figures_1.default.info} Extensions: ${this.options.ext.join(', ')}`));
+            console.log(`${prefix} ${chalk_1.default.blue(`${figures_1.default.info} Extensions: ${this.options.ext.join(', ')}`)}`);
         }
         console.log('');
     }
@@ -129,18 +132,20 @@ class DevRunner {
             await this.fileWatcher.start();
         }
         // Run initial commands
-        logger_1.default.printLine('Starting development server...', 'info');
+        const prefix = chalk_1.default.cyan(`[${this.options.runnerName}]`);
+        logger_1.default.printLine(`${prefix} Starting development server...`, 'info');
         await this.runCommands();
         // Set up graceful shutdown
         this.setupGracefulShutdown();
-        logger_1.default.printLine('Development server started. Watching for changes...', 'info');
-        logger_1.default.printLine(`Press ${chalk_1.default.cyan('Ctrl+C')} to stop`, 'info');
+        logger_1.default.printLine(`${prefix} Development server started. Watching for changes...`, 'info');
+        logger_1.default.printLine(`${prefix} Press ${chalk_1.default.cyan('Ctrl+C')} to stop`, 'info');
     }
     async restart() {
+        const prefix = chalk_1.default.cyan(`[${this.options.runnerName}]`);
         if (!this.isRunning) {
             return;
         }
-        logger_1.default.printLine('Restarting due to file changes...', 'info');
+        logger_1.default.printLine(`${prefix} Restarting due to file changes...`, 'info');
         this.restartCount++;
         // Stop current processes
         if (this.runner) {
@@ -152,13 +157,14 @@ class DevRunner {
         this.printDevBanner();
         // Run commands again
         await this.runCommands();
-        logger_1.default.printLine('Restart completed. Watching for changes...', 'info');
+        logger_1.default.printLine(`${prefix} Restart completed. Watching for changes...`, 'info');
     }
     async stop() {
+        const prefix = chalk_1.default.cyan(`[${this.options.runnerName}]`);
         if (!this.isRunning) {
             return;
         }
-        logger_1.default.printLine('Stopping development server...', 'info');
+        logger_1.default.printLine(`${prefix} Stopping development server...`, 'info');
         this.isRunning = false;
         // Stop file watcher
         if (this.fileWatcher) {
@@ -170,9 +176,9 @@ class DevRunner {
         }
         const uptime = Math.floor((Date.now() - this.startTime.getTime()) / 1000);
         const uptimeStr = this.formatUptime(uptime);
-        logger_1.default.printLine(`Development server stopped after ${uptimeStr}`, 'info');
+        logger_1.default.printLine(`${prefix} ${this.options.runnerName} development server stopped after ${uptimeStr}`, 'info');
         if (this.restartCount > 0) {
-            logger_1.default.printLine(`Total restarts: ${this.restartCount}`, 'info');
+            logger_1.default.printLine(`${prefix} Total restarts: ${this.restartCount}`, 'info');
         }
     }
     setupGracefulShutdown() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neex",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "The Modern Build System for Polyrepo-in-Monorepo Architecture",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -12,7 +12,9 @@
     "start": "node dist/bin/neex.js",
     "prepublishOnly": "npm run build",
     "test": "jest",
-    "test:dev": "node ./dist/bin/neex.js runx \"echo Starting frontend\" \"echo Starting backend\"",
+    "dev": "neex w \"ts-node src/server.ts\"",
+    "w": "neex w \"ts-node src/server.ts\"",
+    "test:dev": "node ./dist/bin/neex.js px \"echo Starting frontend\" \"echo Starting backend\"",
     "test:parallel": "node ./dist/src/cli.js parallel \"echo Building frontend\" \"echo Building backend\"",
     "test:sequence": "node ./dist/src/cli.js run \"echo Step 1\" \"echo Step 2\" \"echo Step 3\""
   },