specrails-hub 1.2.1 → 1.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Javier Pulido
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cli/dist/specrails-hub.js

@@ -24,6 +24,7 @@ exports.formatDuration = formatDuration;
 exports.formatTokens = formatTokens;
 exports.printSummary = printSummary;
 const http_1 = __importDefault(require("http"));
+const net_1 = __importDefault(require("net"));
 const child_process_1 = require("child_process");
 const child_process_2 = require("child_process");
 const readline_1 = require("readline");
@@ -607,6 +608,20 @@ async function handleJobs(port) {
 // Hub subcommand group
 // ---------------------------------------------------------------------------
 const HUB_PID_FILE = path_1.default.join(os_1.default.homedir(), '.specrails', 'manager.pid');
+const HUB_LOG_FILE = path_1.default.join(os_1.default.homedir(), '.specrails', 'hub.log');
+function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const srv = net_1.default.createServer();
+        srv.once('error', (err) => {
+            resolve(err.code === 'EADDRINUSE');
+        });
+        srv.once('listening', () => {
+            srv.close();
+            resolve(false);
+        });
+        srv.listen(port, '127.0.0.1');
+    });
+}
 function readPid() {
     try {
         const raw = fs_1.default.readFileSync(HUB_PID_FILE, 'utf-8').trim();
@@ -648,25 +663,54 @@ async function hubStart(port) {
         cliLog(`hub already running (pid ${pid}) on port ${port}`);
         return 0;
     }
+    // Check if port is already in use by another process
+    const portBusy = await isPortInUse(port);
+    if (portBusy) {
+        cliError(`port ${port} is already in use by another process`);
+        cliError(`if a previous hub is stale, run: specrails-hub stop`);
+        cliError(`or use a different port: specrails-hub --port <port> start`);
+        return 1;
+    }
     const serverPath = hubServerPath();
     const isTs = serverPath.endsWith('.ts');
     const args = isTs
         ? ['tsx', serverPath, '--port', String(port)]
         : ['node', serverPath, '--port', String(port)];
+    // Ensure log dir exists and open log file for server output
+    try {
+        fs_1.default.mkdirSync(path_1.default.dirname(HUB_LOG_FILE), { recursive: true });
+    }
+    catch { /* ignore */ }
+    let logFd;
+    try {
+        logFd = fs_1.default.openSync(HUB_LOG_FILE, 'a');
+    }
+    catch { /* ignore — fall back to silent */ }
+    const stdio = [
+        'ignore',
+        logFd ?? 'ignore',
+        logFd ?? 'ignore',
+    ];
     const child = (0, child_process_2.spawn)(args[0], args.slice(1), {
         detached: true,
-        stdio: 'ignore',
+        stdio,
         env: { ...process.env },
     });
+    if (logFd !== undefined) {
+        try {
+            fs_1.default.closeSync(logFd);
+        }
+        catch { /* ignore */ }
+    }
     child.unref();
-    // Wait briefly and confirm it started
-    await new Promise((resolve) => setTimeout(resolve, 800));
+    // Wait for server to be ready (longer window for slow machines)
+    await new Promise((resolve) => setTimeout(resolve, 2000));
     const detection = await detectWebManager(port);
     if (detection.running) {
         cliLog(`hub started on http://127.0.0.1:${port}`);
         return 0;
     }
-    cliError('hub failed to start (check logs)');
+    cliError(`hub failed to start — logs: ${HUB_LOG_FILE}`);
     return 1;
 }
 async function hubStop() {