arceus-s 1.6.4 → 1.6.5

package/dist/cli/index.js

@@ -99,6 +99,7 @@ Commands:
   analyze [path]                   Index a repository (full analysis)
   index [path...]                 Register an existing .arc/ folder into the global registry
   serve                            Start local HTTP server for web UI connection
+  stop                             Stop the local HTTP server on a port (default: 4747)
   mcp                              Start MCP server (stdio) — serves all indexed repos
   list                             List all indexed repositories
   status                           Show index status for current repo
@@ -175,6 +176,14 @@ Options:
   -p, --port <port>     Port number (default: 4747)
   --host <host>         Bind address (default: 127.0.0.1)`);
             break;
+        case 'stop':
+            console.log(`Usage: ${binName} stop [options]
+
+Stop the local HTTP server on a port
+
+Options:
+  -p, --port <port>     Port number (default: 4747)`);
+            break;
         case 'clean':
             console.log(`Usage: ${binName} clean [options]
 
@@ -369,6 +378,13 @@ async function runCLI() {
             await serveCommand(options);
             break;
         }
+        case 'stop': {
+            if (options.port === undefined)
+                options.port = '4747';
+            const { stopCommand } = await import('./stop.js');
+            await stopCommand(options);
+            break;
+        }
         case 'mcp': {
             const { mcpCommand } = await import('./mcp.js');
             await mcpCommand();

package/dist/cli/stop.d.ts

@@ -0,0 +1,3 @@
+export declare const stopCommand: (options?: {
+    port?: string;
+}) => Promise<void>;

package/dist/cli/stop.js

@@ -0,0 +1,122 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { logger } from '../core/logger.js';
+const execAsync = promisify(exec);
+export const stopCommand = async (options) => {
+    const port = Number(options?.port ?? 4747);
+    if (isNaN(port) || port <= 0 || port > 65535) {
+        console.error(`Error: Invalid port number: ${options?.port}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`Stopping process on port ${port}...`);
+    try {
+        const pids = await findPidsOnPort(port);
+        if (pids.size === 0) {
+            console.log(`No active process found using port ${port}.`);
+            return;
+        }
+        const killedPids = [];
+        const failedPids = [];
+        for (const pid of pids) {
+            if (pid === process.pid) {
+                // Don't kill ourselves
+                continue;
+            }
+            try {
+                await killPid(pid);
+                killedPids.push(pid);
+            }
+            catch (err) {
+                logger.error({ err, pid }, 'Failed to kill process');
+                failedPids.push(pid);
+            }
+        }
+        if (killedPids.length > 0) {
+            console.log(`Successfully stopped process(es) on port ${port} (PID: ${killedPids.join(', ')}).`);
+        }
+        if (failedPids.length > 0) {
+            console.error(`Failed to stop process(es) on port ${port} (PID: ${failedPids.join(', ')}).`);
+            process.exitCode = 1;
+        }
+    }
+    catch (err) {
+        console.error(`Error while scanning port ${port}:`, err.message || err);
+        process.exitCode = 1;
+    }
+};
+async function findPidsOnPort(port) {
+    const pids = new Set();
+    if (process.platform === 'win32') {
+        try {
+            const { stdout } = await execAsync('netstat -ano');
+            const lines = stdout.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                const parts = trimmed.split(/\s+/);
+                if (parts.length < 4)
+                    continue;
+                // Local address is the second column (index 1)
+                const localAddress = parts[1];
+                if (localAddress &&
+                    (localAddress.endsWith(`:${port}`) || localAddress.endsWith(`]:${port}`))) {
+                    const pidStr = parts[parts.length - 1];
+                    const pid = parseInt(pidStr, 10);
+                    if (!isNaN(pid) && pid > 0) {
+                        pids.add(pid);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            logger.debug({ err }, 'netstat execution failed');
+            throw new Error(`Failed to list connections via netstat: ${err.message}`);
+        }
+    }
+    else {
+        // macOS / Linux
+        try {
+            const { stdout } = await execAsync(`lsof -t -i :${port}`);
+            const lines = stdout.trim().split('\n');
+            for (const line of lines) {
+                const pid = parseInt(line.trim(), 10);
+                if (!isNaN(pid) && pid > 0) {
+                    pids.add(pid);
+                }
+            }
+        }
+        catch (err) {
+            // lsof returns exit code 1 if no matches are found, which is not a real failure
+            if (err.code !== 1) {
+                // Try fallback to fuser
+                try {
+                    const { stdout } = await execAsync(`fuser ${port}/tcp`);
+                    const lines = stdout.trim().split(/\s+/);
+                    for (const line of lines) {
+                        const pid = parseInt(line.trim(), 10);
+                        if (!isNaN(pid) && pid > 0) {
+                            pids.add(pid);
+                        }
+                    }
+                }
+                catch (fuserErr) {
+                    logger.debug({ fuserErr }, 'fuser execution failed');
+                    if (fuserErr.code !== 1) {
+                        throw new Error(`Failed to list connections via lsof/fuser: ${err.message}`);
+                    }
+                }
+            }
+        }
+    }
+    return pids;
+}
+async function killPid(pid) {
+    if (process.platform === 'win32') {
+        await execAsync(`taskkill /F /PID ${pid}`);
+    }
+    else {
+        await execAsync(`kill -9 ${pid}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arceus-s",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Chandan Kumar Behera",
   "license": "PolyForm-Noncommercial-1.0.0",
@@ -119,4 +119,4 @@
   "engines": {
     "node": ">=22.0.0"
   }
-}
+}