@yamanzyan/monitorx 1.0.0

package/README.md

@@ -0,0 +1,236 @@
+# MonitorX
+
+A lightweight Node.js process manager with built-in cluster support. Run, monitor, and manage your Node.js processes from the command line.
+
+## Features
+
+- Start and manage multiple processes
+- Node.js cluster mode — share a port across N workers with zero code changes
+- Persistent state — processes restore automatically after daemon restart
+- Live log streaming
+- Per-process CPU and memory usage
+
+## Installation
+
+```bash
+npm install -g monitorx
+```
+
+The install script starts the MonitorX daemon in the background automatically.
+This also installs two binaries:
+
+| Binary | Purpose |
+|---|---|
+| `monitorx` | CLI — send commands to the daemon |
+| `monitorx-daemon` | Daemon — background process that manages your apps |
+
+## Quick Start
+
+**Start a process:**
+
+```bash
+# Start a script directly
+monitorx start server.js
+
+# Start using a config file
+monitorx start
+
+# List running processes
+monitorx ls
+```
+
+If the daemon is not running, start it manually:
+
+```bash
+monitorx-daemon --daemonize
+```
+
+## Commands
+
+### `monitorx start`
+
+Start one or more processes.
+
+```bash
+# Start all processes defined in monitorx.config.js
+monitorx start
+
+# Start a specific script file
+monitorx start server.js
+
+# Start a script with a custom name
+monitorx start server.js -n api
+
+# Start a stopped process by name
+monitorx start api
+
+# Start a stopped process by ID
+monitorx start 3
+
+# Start script as a cluster with 4 workers
+monitorx start server.js -i 4
+
+# Start cluster with a custom name
+monitorx start server.js -n api -i 4
+```
+
+**Flags:**
+
+| Flag | Alias | Description |
+|---|---|---|
+| `-i <count>` | `--instances` | Number of cluster workers. Values > 1 enable cluster mode |
+| `-n <name>` | `--name` | Custom name for the process (only for direct script starts) |
+
+### `monitorx stop`
+
+Stop one or more running processes.
+
+```bash
+# Stop all processes
+monitorx stop
+
+# Stop by name (stops all workers if cluster)
+monitorx stop api
+
+# Stop a specific process or cluster worker by ID
+monitorx stop 2
+```
+
+### `monitorx restart`
+
+Restart a process.
+
+```bash
+# Restart all processes named "api"
+monitorx restart api
+
+# Restart a specific process by ID
+monitorx restart 2
+```
+
+### `monitorx delete`
+
+Remove processes from the registry (stops them first if running).
+
+```bash
+# Delete all processes
+monitorx delete
+
+# Delete by name
+monitorx delete api
+
+# Delete by ID
+monitorx delete 2
+```
+
+### `monitorx ls`
+
+List all processes:
+
+```
+┌────┬──────────────────┬──────────┬───────┬─────────┬──────────────┬───────────┬──────────────┐
+│ ID │ Process Name     │ PID      │ Mode  │ Status  │ Time Running │ CPU Usage │ Memory Usage │
+├────┼──────────────────┼──────────┼───────┼─────────┼──────────────┼───────────┼──────────────┤
+│ 1  │ api              │ 12340    │ fork  │ Running │ 120s         │ 0.05s     │ 48 MB        │
+│ 2  │ worker           │ 12341    │ cluster│ Running │ 60s         │ 0.02s     │ 32 MB        │
+│ 3  │ worker           │ 12342    │ cluster│ Running │ 60s         │ 0.02s     │ 32 MB        │
+│ 4  │ worker           │ 12343    │ cluster│ Running │ 60s         │ 0.02s     │ 32 MB        │
+└────┴──────────────────┴──────────┴───────┴─────────┴──────────────┴───────────┴──────────────┘
+```
+
+**Mode** column:
+- `fork` — single independent process
+- `cluster` — Node.js cluster worker (all workers with the same name share one port)
+
+### `monitorx logs`
+
+Stream live output from processes.
+
+```bash
+# Stream all process logs
+monitorx logs
+
+# Stream logs from a specific process
+monitorx logs api
+
+# Stream logs from a specific worker by ID
+monitorx logs 3
+```
+
+Press `Ctrl+C` to stop streaming.
+
+### `monitorx help`
+
+```bash
+# Show all commands
+monitorx help
+
+# Show detailed help for a command
+monitorx help start
+```
+
+## Config File
+
+Create `monitorx.config.js` in your project root:
+
+```js
+export default {
+  processes: [
+    // Simple fork process
+    { name: 'api', script: 'node src/server.js' },
+
+    // Cluster mode — 4 workers sharing the same port
+    { name: 'worker', script: 'node src/worker.js', instances: 4 },
+  ],
+};
+```
+
+Then run:
+
+```bash
+monitorx start
+```
+
+### Config fields
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `name` | string | yes | Identifier shown in `monitorx ls` |
+| `script` | string | yes | Shell command to run (e.g. `node src/app.js`) |
+| `instances` | number | no | Workers to spawn. Values > 1 enable cluster mode |
+
+## Cluster Mode
+
+MonitorX uses Node.js's built-in `cluster` module. The daemon acts as the cluster primary — each worker is a separate entry in `monitorx ls` with its own ID and PID.
+
+Workers share a port without any changes to your application code:
+
+```js
+// server.js — no cluster code needed
+import http from 'node:http';
+
+http.createServer((req, res) => {
+  res.end(`hello from PID ${process.pid}\n`);
+}).listen(3000);
+```
+
+```bash
+monitorx start server.js -i 4
+# Starts 4 workers, all listening on :3000
+# Incoming connections are distributed round-robin
+```
+
+**Crash recovery:** if a cluster worker crashes unexpectedly, MonitorX automatically forks a replacement. Workers stopped via `monitorx stop` are not restarted.
+
+## State Persistence
+
+MonitorX saves process state to `~/.monitorx/process_state.json`. When the daemon restarts, all processes that were running are automatically relaunched (including cluster workers).
+
+## Data Directory
+
+All MonitorX files live in `~/.monitorx/`:
+
+| File | Purpose |
+|---|---|
+| `daemon.sock` | Unix socket for CLI ↔ daemon communication |
+| `process_state.json` | Persisted process registry |

package/dist/cli/commands.d.ts

@@ -0,0 +1,3 @@
+import net from "node:net";
+declare const commands: Record<string, (client: net.Socket, arg1?: string | number, ...args: string[]) => Promise<void>>;
+export { commands };

package/dist/cli/commands.js

@@ -0,0 +1,183 @@
+// --- Command handlers ---
+import fs from "node:fs";
+import logger from "../logger.js";
+import { MessageType, SCRIPT_SERVER } from "../protocol.js";
+import { send } from "./data-handler.js";
+import { printHelp } from "./help.js";
+const flags = ['-i', '--instances', '-n', '--name'];
+const commands = {
+    async start(client, arg1, ...args) {
+        let flagArgs = [];
+        if (args.length > 0) {
+            for (let i = 0; i < args.length; i++) {
+                const arg = args[i];
+                if (flags.includes(arg) && i + 1 < args.length) {
+                    flagArgs.push([arg, args[i + 1]]);
+                    i++;
+                }
+                else {
+                    logger.error(`Unknown flag: ${arg}`);
+                    return;
+                }
+            }
+        }
+        const instancesFlag = flagArgs.find(([flag]) => flag === "-i" || flag === "--instances");
+        const instances = instancesFlag ? parseInt(instancesFlag[1], 10) : undefined;
+        const nameFlag = flagArgs.find(([flag]) => flag === "-n" || flag === "--name");
+        const name = nameFlag ? nameFlag[1] : undefined;
+        if (instances !== undefined && (isNaN(instances) || instances < 1)) {
+            logger.error("Invalid value for -i flag: must be a positive integer");
+            return;
+        }
+        // Case 2: monitorx start <id> — send id to daemon, it handles restarting stopped process
+        if (arg1 && !isNaN(Number(arg1))) {
+            send(client, {
+                type: MessageType.START,
+                processes: [],
+                id: Number(arg1),
+                cwd: process.cwd(),
+            });
+            return;
+        }
+        // Case 3: pmon start <script> — file exists, start it directly
+        if (arg1) {
+            const processPath = `${process.cwd()}/${arg1}`;
+            if (fs.existsSync(processPath)) {
+                send(client, {
+                    type: MessageType.START,
+                    processes: [
+                        {
+                            name: name ?? SCRIPT_SERVER,
+                            script: `node ${processPath}`,
+                            instances,
+                        },
+                    ],
+                    byScript: true,
+                    cwd: process.cwd(),
+                });
+                return;
+            }
+        }
+        // Case 4: pmon start <name> — start stopped processes with that name
+        // Also check monitorx.config.js for the process config so daemon can start it fresh if needed
+        if (arg1) {
+            const processConfigFile = `${process.cwd()}/monitorx.config.js`;
+            let processes = [];
+            if (fs.existsSync(processConfigFile)) {
+                const processConfig = await import(processConfigFile);
+                const data = processConfig.default;
+                if (data.processes && Array.isArray(data.processes)) {
+                    processes = data.processes
+                        .filter((proc) => proc.name === arg1)
+                        .map((proc) => ({
+                        ...proc,
+                        instances: instances ?? proc.instances,
+                    }));
+                }
+            }
+            send(client, {
+                type: MessageType.START,
+                processes,
+                name: arg1,
+                cwd: process.cwd(),
+            });
+            return;
+        }
+        // Case 1: pmon start — use monitorx.config.js
+        const processConfigFile = `${process.cwd()}/monitorx.config.js`;
+        if (!fs.existsSync(processConfigFile)) {
+            logger.error("No process config file found");
+            logger.info("Please create a monitorx.config.js file in the current working directory");
+            return;
+        }
+        const processConfig = await import(processConfigFile);
+        const data = processConfig.default;
+        if (!data.processes || !Array.isArray(data.processes)) {
+            logger.error("Invalid process config file format");
+            logger.info("Please ensure monitorx.config.js exports an object with a 'processes' array");
+            return;
+        }
+        send(client, {
+            type: MessageType.START,
+            processes: data.processes,
+            cwd: process.cwd(),
+        });
+    },
+    /**
+     * Logs process output to console.
+     *
+     * @param client
+     * @param subcommand
+     */
+    async logs(client, arg1) {
+        console.log(`Subscribing to logs for process: ${arg1 ?? "(all)"}`);
+        if (!isNaN(Number(arg1))) {
+            send(client, { type: MessageType.LOGS, id: Number(arg1) });
+        }
+        else {
+            send(client, { type: MessageType.LOGS, name: arg1 });
+        }
+    },
+    /**
+     * Stops a process by name, or all processes if no name is provided.
+     * @param client
+     * @param subcommand
+     */
+    async stop(client, arg1) {
+        console.log(`Stopping process: ${arg1 ?? "(all)"}`);
+        const id = Number(arg1);
+        if (!isNaN(id)) {
+            console.log(`Stopping process with id: ${id}`);
+            send(client, { type: MessageType.STOP, id });
+            return;
+        }
+        console.log(`Stopping all processes named: ${arg1}`);
+        send(client, { type: MessageType.STOP, name: arg1 });
+    },
+    async restart(client, arg1) {
+        if (!arg1) {
+            logger.error("Please provide a process name or id to restart");
+            client.unref();
+            return;
+        }
+        const id = Number(arg1);
+        if (!isNaN(id)) {
+            console.log(`Restarting process with id: ${id}`);
+            send(client, { type: MessageType.RESTART, id });
+        }
+        else {
+            console.log(`Restarting all processes named: ${arg1}`);
+            send(client, { type: MessageType.RESTART, name: arg1 });
+        }
+    },
+    async delete(client, arg1) {
+        if (!arg1) {
+            console.log("Deleting all processes...");
+            send(client, { type: MessageType.DELETE });
+            return;
+        }
+        const id = Number(arg1);
+        if (!isNaN(id)) {
+            console.log(`Deleting process with id: ${id}`);
+            send(client, { type: MessageType.DELETE, id });
+        }
+        else {
+            console.log(`Deleting all processes named: ${arg1}`);
+            send(client, { type: MessageType.DELETE, name: arg1 });
+        }
+    },
+    /**
+     * Lists all processes with their status and resource usage.
+     * @param client
+     */
+    async ls(client) {
+        console.log("Listing processes...");
+        send(client, { type: MessageType.LS });
+    },
+    async help(_client, arg1) {
+        printHelp(arg1);
+        _client.unref();
+    },
+};
+export { commands };
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/data-handler.d.ts

@@ -0,0 +1,12 @@
+import { ResponseMessage } from "../protocol.js";
+import net from "node:net";
+declare function send(client: net.Socket, payload: object): void;
+/**
+ * Handles responses which are sent by the daemon in response to commands.
+ * This includes log output, process lists, and error messages.
+ *
+ * @param message
+ * @param client
+ */
+declare function handleResponse(message: ResponseMessage, client: net.Socket): void;
+export { send, handleResponse };

package/dist/cli/data-handler.js

@@ -0,0 +1,59 @@
+import { MessageType } from "../protocol.js";
+import Table from "cli-table3";
+function send(client, payload) {
+    client.write(JSON.stringify(payload) + "\n");
+}
+// --- Response handler ---
+/**
+ * Handles responses which are sent by the daemon in response to commands.
+ * This includes log output, process lists, and error messages.
+ *
+ * @param message
+ * @param client
+ */
+function handleResponse(message, client) {
+    switch (message.type) {
+        case MessageType.LOG:
+            process.stdout.write(message.data);
+            break;
+        case MessageType.LS:
+            let table = new Table({
+                head: [
+                    "ID",
+                    "Process Name",
+                    "PID",
+                    "Mode",
+                    "Status",
+                    "Time Running",
+                    "CPU Usage",
+                    "Memory Usage",
+                ],
+            });
+            message.data.forEach((proc) => {
+                const status = proc.status;
+                const mode = proc.mode === "cluster" ? "cluster" : "fork";
+                const timeRunning = proc.startTime
+                    ? `${Math.floor((Date.now() - proc.startTime) / 1000)}s`
+                    : "-";
+                const cpu = proc.usage?.cpu ?? "-";
+                const memory = proc.usage?.memory ?? "-";
+                table.push([
+                    proc.id,
+                    proc.name,
+                    proc.pid ?? "Not running",
+                    mode,
+                    status,
+                    timeRunning,
+                    cpu,
+                    memory,
+                ]);
+            });
+            console.log(table.toString());
+            client.unref();
+            break;
+        default:
+            console.log("received", message);
+    }
+}
+export { send, handleResponse };
+//# sourceMappingURL=data-handler.js.map

package/dist/cli/data-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-handler.js","sourceRoot":"","sources":["../../src/cli/data-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,SAAS,IAAI,CAAC,MAAkB,EAAE,OAAe;IAChD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9C,CAAC;AAGD,2BAA2B;AAC3B;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,OAAwB,EAAE,MAAkB;IACnE,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,WAAW,CAAC,GAAG;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM;QACP,KAAK,WAAW,CAAC,EAAE;YAClB,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC;gBACrB,IAAI,EAAE;oBACL,IAAI;oBACJ,cAAc;oBACd,KAAK;oBACL,MAAM;oBACN,QAAQ;oBACR,cAAc;oBACd,WAAW;oBACX,cAAc;iBACd;aACD,CAAC,CAAC;YAEH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS;oBACjC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG;oBACxD,CAAC,CAAC,GAAG,CAAC;gBACP,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,GAAG,CAAC;gBACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC;oBACV,IAAI,CAAC,EAAE;oBACP,IAAI,CAAC,IAAI;oBACT,IAAI,CAAC,GAAG,IAAI,aAAa;oBACzB,IAAI;oBACJ,MAAM;oBACN,WAAW;oBACX,GAAG;oBACH,MAAM;iBACN,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM;QACP;YACC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;AACF,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,2 @@
+declare function printHelp(command?: string): void;
+export { printHelp };

package/dist/cli/help.js

@@ -0,0 +1,115 @@
+// --- Help ---
+const COMMAND_HELP = {
+    start: {
+        usage: "monitorx start [name|id|script] [-i <count>] [-n <name>]",
+        description: "Start one or more processes.",
+        details: [
+            "  monitorx start                  Read monitorx.config.js and start all configured processes",
+            "  monitorx start <name>           Start stopped process(es) matching <name>",
+            "  monitorx start <id>             Restart a stopped process by its numeric ID",
+            "  monitorx start <script.js>      Start a script file directly (registered as 'server')",
+            "  monitorx start <script.js> -i 4 Start script as a cluster with 4 workers",
+            "  monitorx start <script.js> -n api -i 4  Start cluster named 'api' with 4 workers",
+            "",
+            "Flags:",
+            "  -i, --instances <count>   Number of cluster workers (>1 enables cluster mode)",
+            "  -n, --name <name>         Custom process name (only for direct script start)",
+            "",
+            "Config file format (monitorx.config.js):",
+            "  export default {",
+            "    processes: [",
+            "      { name: 'api', script: 'node src/server.js' },",
+            "      { name: 'worker', script: 'node src/worker.js', instances: 4 },",
+            "    ]",
+            "  };",
+        ],
+    },
+    stop: {
+        usage: "monitorx stop [name|id]",
+        description: "Stop one or more running processes.",
+        details: [
+            "  monitorx stop                   Stop all running processes",
+            "  monitorx stop <name>            Stop all processes matching <name>",
+            "  monitorx stop <id>              Stop process by numeric ID",
+        ],
+    },
+    restart: {
+        usage: "monitorx restart <name|id>",
+        description: "Restart a running or stopped process.",
+        details: [
+            "  monitorx restart <name>         Restart all processes matching <name>",
+            "  monitorx restart <id>           Restart process by numeric ID",
+            "",
+            "Note: <name> or <id> is required.",
+        ],
+    },
+    delete: {
+        usage: "monitorx delete [name|id]",
+        description: "Remove process(es) from monitorx's registry.",
+        details: [
+            "  monitorx delete                 Delete all processes",
+            "  monitorx delete <name>          Delete all processes matching <name>",
+            "  monitorx delete <id>            Delete process by numeric ID",
+            "",
+            "Note: Stops the process before deleting if it is running.",
+        ],
+    },
+    logs: {
+        usage: "monitorx logs [name]",
+        description: "Stream log output from a process.",
+        details: [
+            "  monitorx logs                   Stream logs from all processes",
+            "  monitorx logs <name>            Stream logs from processes matching <name>",
+            "",
+            "Note: Output streams live until you press Ctrl+C.",
+        ],
+    },
+    ls: {
+        usage: "monitorx ls",
+        description: "List all processes with status and resource usage.",
+        details: [
+            "  monitorx ls                     Show table: ID, name, PID, mode, status, uptime, CPU, memory",
+            "",
+            "Mode values:",
+            "  fork       Single process (default)",
+            "  cluster    Node.js cluster worker (shares port with siblings)",
+            "",
+            "Status values:",
+            "  Running    Process is active",
+            "  Stopped    Process has exited or was stopped",
+            "  Errored    Process exited with non-zero code",
+        ],
+    },
+    help: {
+        usage: "monitorx help [command]",
+        description: "Show help for monitorx or a specific command.",
+        details: [
+            "  monitorx help                   Show all available commands",
+            "  monitorx help <command>         Show detailed manual for <command>",
+        ],
+    },
+};
+function printHelp(command) {
+    if (command && COMMAND_HELP[command]) {
+        const h = COMMAND_HELP[command];
+        console.log(`\nUsage: ${h.usage}`);
+        console.log(`\n${h.description}\n`);
+        h.details.forEach((line) => console.log(line));
+        console.log();
+        return;
+    }
+    if (command) {
+        console.log(`Unknown command: ${command}`);
+        console.log("Run 'monitorx help' to see all available commands.\n");
+        return;
+    }
+    console.log("\nUsage: monitorx <command> [args]\n");
+    console.log("Commands:\n");
+    const maxLen = Math.max(...Object.keys(COMMAND_HELP).map((k) => k.length));
+    for (const [cmd, h] of Object.entries(COMMAND_HELP)) {
+        console.log(`  ${cmd.padEnd(maxLen + 2)}${h.description}`);
+    }
+    console.log("\nRun 'monitorx help <command>' for detailed usage.\n");
+}
+export { printHelp };
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};