neex 0.1.5 → 0.1.7

package/README.md

@@ -6,7 +6,7 @@
 </picture>
 </a>
 
-# Neex v0.1.5
+# Neex v0.1.7
 
 ### 🚀 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')
@@ -156,11 +197,11 @@ function cli() {
             process.exit(1);
         }
     });
-    // Watch command (Nodemon functionality)
+    // Dev command (Nodemon functionality - formerly watch)
     program
-        .command('watch <commands...>')
-        .alias('w')
-        .description('Run commands with file watching (nodemon functionality)')
+        .command('dev [commands...]') // Made commands optional
+        .alias('d')
+        .description('Run commands with file watching and auto-restart (nodemon functionality)')
         .option('-c, --no-color', 'Disable colored output')
         .option('-t, --no-timing', 'Hide timing information')
         .option('-p, --no-prefix', 'Hide command prefix')
@@ -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 dev', using default: "${foundCommand}"`));
+                }
+                else {
+                    console.error(chalk_1.default.red(`${figures_1.default.cross} No command specified for 'neex dev' 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 dev "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 dev) 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 dev',
                 parallel: false,
                 color: options.color,
                 showTiming: options.timing,
@@ -207,16 +293,16 @@ 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) {
-                console.error(chalk_1.default.red(`${figures_1.default.cross} Watch Error: ${error.message}`));
+                console.error(chalk_1.default.red(`${figures_1.default.cross} Dev Error: ${error.message}`));
             }
             else {
-                console.error(chalk_1.default.red(`${figures_1.default.cross} An unknown watch error occurred`));
+                console.error(chalk_1.default.red(`${figures_1.default.cross} An unknown dev error occurred`));
             }
             process.exit(1);
         }
@@ -406,7 +492,7 @@ function cli() {
         .command('logs [id]')
         .description('Show process logs')
         .option('-f, --follow', 'Follow log output')
-        .option('-n, --lines <number>', 'Number of lines to show', parseInt)
+        .option('-n, --lines <number>', 'Number of lines to show', (value) => parseInt(value, 10), 15)
         .action(async (id, options) => {
         try {
             if (!processManager) {
@@ -414,7 +500,7 @@ function cli() {
                 await processManager.load();
             }
             if (id) {
-                const logs = await processManager.logs(id, options.lines || 100);
+                const logs = await processManager.logs(id, options.lines);
                 if (logs.length === 0) {
                     console.log(chalk_1.default.yellow(`${figures_1.default.info} No logs found for process ${id}`));
                 }
@@ -594,7 +680,7 @@ WantedBy=multi-user.target
         program.help();
     }
     // Graceful shutdown handling
-    const handleSignal = (signal) => {
+    const handleSignal = async (signal) => {
         console.log(`\n${chalk_1.default.yellow(`${figures_1.default.warning} Received ${signal}. Cleaning up...`)}`);
         if (devRunner && devRunner.isActive()) {
             devRunner.stop();
@@ -603,13 +689,13 @@ WantedBy=multi-user.target
             cleanupRunner();
         }
         if (processManager) {
-            processManager.dispose();
+            await processManager.dispose();
         }
         setTimeout(() => process.exit(0), 500);
     };
-    process.on('SIGINT', () => handleSignal('SIGINT'));
-    process.on('SIGTERM', () => handleSignal('SIGTERM'));
-    process.on('SIGQUIT', () => handleSignal('SIGQUIT'));
+    process.on('SIGINT', () => handleSignal('SIGINT').catch(err => console.error('SIGINT handler error:', err)));
+    process.on('SIGTERM', () => handleSignal('SIGTERM').catch(err => console.error('SIGTERM handler error:', err)));
+    process.on('SIGQUIT', () => handleSignal('SIGQUIT').catch(err => console.error('SIGQUIT handler error:', err)));
 }
 exports.default = cli;
 // Helper function to format uptime

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/dist/src/process-manager.js

@@ -29,26 +29,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessManager = void 0;
 // src/process-manager.ts - PM2 alternative process manager
 const child_process_1 = require("child_process");
-const fs = __importStar(require("fs/promises"));
+const fsFull = __importStar(require("fs")); // Renamed to fsFull to avoid conflicts
+const fs_1 = require("fs");
 const path = __importStar(require("path"));
 const events_1 = require("events");
 const logger_1 = __importDefault(require("./logger"));
 class ProcessManager extends events_1.EventEmitter {
     constructor(configPath) {
         super();
+        this.logStreams = new Map();
         this.processes = new Map();
         this.isMonitoring = false;
         this.configPath = configPath || path.join(process.cwd(), '.neex', 'processes.json');
-        this.ensureConfigDir();
+        this.logDir = path.join(path.dirname(this.configPath), 'logs');
+        this.ensureConfigDirAndLogDir(); // Renamed and updated
+        // loadConfig will be called by CLI commands as needed before operations like list, stop, etc.
         this.startMonitoring();
     }
-    async ensureConfigDir() {
+    async ensureConfigDirAndLogDir() {
         const dir = path.dirname(this.configPath);
         try {
-            await fs.mkdir(dir, { recursive: true });
+            await fs_1.promises.mkdir(dir, { recursive: true });
+            await fs_1.promises.mkdir(this.logDir, { recursive: true });
         }
         catch (error) {
-            // Directory might already exist
+            logger_1.default.printLine(`Failed to create config/log directories: ${error.message}`, 'error');
+            // Directory might already exist or other error
         }
     }
     async saveConfig() {
@@ -59,7 +65,7 @@ class ProcessManager extends events_1.EventEmitter {
                 created_at: proc.created_at,
                 restarts: proc.restarts
             }));
-            await fs.writeFile(this.configPath, JSON.stringify(config, null, 2));
+            await fs_1.promises.writeFile(this.configPath, JSON.stringify(config, null, 2));
         }
         catch (error) {
             logger_1.default.printLine(`Failed to save config: ${error.message}`, 'error');
@@ -67,7 +73,7 @@ class ProcessManager extends events_1.EventEmitter {
     }
     async loadConfig() {
         try {
-            const data = await fs.readFile(this.configPath, 'utf-8');
+            const data = await fs_1.promises.readFile(this.configPath, 'utf-8');
             const configs = JSON.parse(data);
             for (const config of configs) {
                 if (config.id && !this.processes.has(config.id)) {
@@ -99,8 +105,39 @@ class ProcessManager extends events_1.EventEmitter {
         }
         return id;
     }
+    closeLogStreams(id) {
+        var _a, _b;
+        const streams = this.logStreams.get(id);
+        if (streams) {
+            (_a = streams.out) === null || _a === void 0 ? void 0 : _a.end();
+            (_b = streams.err) === null || _b === void 0 ? void 0 : _b.end();
+            this.logStreams.delete(id);
+        }
+    }
     async startProcess(processInfo) {
         const { config } = processInfo;
+        // Setup log files
+        const defaultLogPath = (type) => path.join(this.logDir, `${processInfo.id}.${type}.log`);
+        config.out_file = config.out_file || defaultLogPath('out');
+        config.error_file = config.error_file || defaultLogPath('err');
+        this.closeLogStreams(processInfo.id); // Ensure any previous streams for this ID are closed (e.g., on restart)
+        let outStream;
+        let errStream;
+        try {
+            if (config.out_file) {
+                await fs_1.promises.mkdir(path.dirname(config.out_file), { recursive: true }); // Ensure directory for custom log file exists
+                outStream = fsFull.createWriteStream(config.out_file, { flags: 'a' });
+                this.logStreams.set(processInfo.id, { ...this.logStreams.get(processInfo.id), out: outStream });
+            }
+            if (config.error_file) {
+                await fs_1.promises.mkdir(path.dirname(config.error_file), { recursive: true }); // Ensure directory for custom log file exists
+                errStream = fsFull.createWriteStream(config.error_file, { flags: 'a' });
+                this.logStreams.set(processInfo.id, { ...this.logStreams.get(processInfo.id), err: errStream });
+            }
+        }
+        catch (streamError) {
+            logger_1.default.printLine(`Failed to open log streams for ${processInfo.id}: ${streamError.message}`, 'error');
+        }
         try {
             processInfo.status = 'launching';
             this.emit('process:launching', processInfo);
@@ -121,7 +158,18 @@ class ProcessManager extends events_1.EventEmitter {
             processInfo.pid = childProcess.pid;
             processInfo.status = 'online';
             processInfo.created_at = new Date();
+            // Allow parent to exit independently of the child
+            if (childProcess.pid) { // unref only if process spawned successfully
+                childProcess.unref();
+            }
             this.emit('process:start', processInfo);
+            // Pipe to log files if streams are available
+            if (outStream && childProcess.stdout) {
+                childProcess.stdout.pipe(outStream);
+            }
+            if (errStream && childProcess.stderr) {
+                childProcess.stderr.pipe(errStream);
+            }
             // Handle stdout
             if (childProcess.stdout) {
                 childProcess.stdout.on('data', (data) => {
@@ -147,6 +195,8 @@ class ProcessManager extends events_1.EventEmitter {
                 processInfo.status = code === 0 ? 'stopped' : 'errored';
                 processInfo.process = undefined;
                 processInfo.pid = undefined;
+                // Note: Streams are not closed here on 'exit' to allow logs to be read after a crash.
+                // They are closed on explicit stop/delete or neex shutdown.
                 this.emit('process:exit', { processInfo, code, signal });
                 // Auto-restart if enabled
                 if (config.autorestart && processInfo.restarts < (config.max_restarts || 10)) {
@@ -252,6 +302,7 @@ class ProcessManager extends events_1.EventEmitter {
         processInfo.status = 'stopped';
         processInfo.process = undefined;
         processInfo.pid = undefined;
+        this.closeLogStreams(id);
         await this.saveConfig();
         this.emit('process:stop', processInfo);
     }
@@ -278,9 +329,22 @@ class ProcessManager extends events_1.EventEmitter {
         if (processInfo.status === 'online') {
             await this.stop(id);
         }
+        const currentProcessInfo = this.processes.get(id);
+        if (currentProcessInfo) {
+            if (currentProcessInfo.status === 'online' || currentProcessInfo.status === 'launching' || currentProcessInfo.status === 'stopping') {
+                // stop() will call closeLogStreams
+            }
+            else {
+                this.closeLogStreams(id); // Ensure closed for other states before deleting
+            }
+        }
+        // Optional: Delete actual log files if `delete` implies full data removal
+        // if (config.out_file) await fsPromises.unlink(config.out_file).catch(() => {});
+        // if (config.error_file) await fsPromises.unlink(config.error_file).catch(() => {});
         this.processes.delete(id);
         await this.saveConfig();
-        this.emit('process:delete', processInfo);
+        if (currentProcessInfo)
+            this.emit('process:delete', currentProcessInfo);
     }
     async list() {
         return Array.from(this.processes.values());
@@ -295,10 +359,42 @@ class ProcessManager extends events_1.EventEmitter {
         }
         return this.list();
     }
-    async logs(id, lines = 100) {
-        // TODO: Implement log file reading
-        // For now, return empty array
-        return [];
+    async logs(id, lines = 15) {
+        let processInfo = this.processes.get(id);
+        if (!processInfo) {
+            await this.loadConfig(); // Attempt to load if not in memory
+            processInfo = this.processes.get(id);
+            if (!processInfo) {
+                throw new Error(`Process ${id} not found`);
+            }
+        }
+        return this.readLogFiles(processInfo.config, lines);
+    }
+    async readLogFiles(config, linesToRead) {
+        const finalMessages = [];
+        const { out_file, error_file } = config;
+        const readFileLastLines = async (filePath) => {
+            if (!filePath)
+                return [];
+            try {
+                await fs_1.promises.access(filePath);
+                const content = await fs_1.promises.readFile(filePath, 'utf-8');
+                const fileLines = content.split('\n').filter((line) => line.trim() !== '');
+                return fileLines.slice(-linesToRead);
+            }
+            catch (error) {
+                // Log file might not exist or not be readable, return empty
+                return [];
+            }
+        };
+        const outLogs = await readFileLastLines(out_file);
+        const errLogs = await readFileLastLines(error_file);
+        outLogs.forEach(log => finalMessages.push(log));
+        if (errLogs.length > 0 && outLogs.length > 0) {
+            finalMessages.push('--- STDERR ---'); // Separator
+        }
+        errLogs.forEach(log => finalMessages.push(log));
+        return finalMessages;
     }
     async save() {
         await this.saveConfig();
@@ -322,7 +418,7 @@ class ProcessManager extends events_1.EventEmitter {
     getProcess(id) {
         return this.processes.get(id);
     }
-    dispose() {
+    async dispose() {
         this.stopMonitoring();
         this.stopAll();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neex",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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\""
   },