twining-mcp 1.3.0

package/dist/dashboard/http-server.js

@@ -0,0 +1,177 @@
+/**
+ * Embedded HTTP server for the Twining dashboard.
+ *
+ * CRITICAL: Never use console.log or process.stdout in this module.
+ * The MCP StdioServerTransport owns stdout exclusively — any writes
+ * corrupt the JSON-RPC byte stream.
+ */
+import http from "node:http";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getDashboardConfig } from "./dashboard-config.js";
+import { createApiHandler } from "./api-routes.js";
+/** MIME types for static assets served from the public directory. */
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+};
+/**
+ * Create a static file serving handler for the given directory.
+ * Includes path traversal prevention (403) and 404 for missing files.
+ */
+function serveStatic(publicDir) {
+    return async (req, res) => {
+        // Parse URL to strip query strings, but use raw pathname for traversal check
+        const rawUrl = req.url || "/";
+        const qIndex = rawUrl.indexOf("?");
+        const rawPath = qIndex >= 0 ? rawUrl.slice(0, qIndex) : rawUrl;
+        const decodedPath = decodeURIComponent(rawPath);
+        const pathname = decodedPath === "/" ? "/index.html" : decodedPath;
+        const filePath = path.join(publicDir, pathname);
+        // Path traversal prevention
+        const resolved = path.resolve(filePath);
+        if (!resolved.startsWith(path.resolve(publicDir))) {
+            res.writeHead(403);
+            res.end("Forbidden");
+            return;
+        }
+        try {
+            const data = await fs.readFile(resolved);
+            const ext = path.extname(resolved);
+            res.writeHead(200, {
+                "Content-Type": MIME_TYPES[ext] || "application/octet-stream",
+            });
+            res.end(data);
+        }
+        catch (err) {
+            const code = err instanceof Error && "code" in err
+                ? err.code
+                : undefined;
+            if (code === "ENOENT") {
+                res.writeHead(404);
+                res.end("Not Found");
+            }
+            else {
+                res.writeHead(500);
+                res.end("Internal Server Error");
+            }
+        }
+    };
+}
+/**
+ * Attempt to bind the server to a port, retrying on EADDRINUSE.
+ * Returns the actual port the server bound to.
+ */
+function tryListen(server, port, maxRetries) {
+    return new Promise((resolve, reject) => {
+        let attempts = 0;
+        function attempt(currentPort) {
+            server.once("error", (err) => {
+                if (err.code === "EADDRINUSE" && attempts < maxRetries) {
+                    attempts++;
+                    attempt(currentPort + 1);
+                }
+                else {
+                    reject(err);
+                }
+            });
+            server.listen(currentPort, "127.0.0.1", () => {
+                // When port is 0, OS assigns a random port — read the actual port
+                const addr = server.address();
+                const actualPort = typeof addr === "object" && addr !== null ? addr.port : currentPort;
+                resolve(actualPort);
+            });
+        }
+        attempt(port);
+    });
+}
+/**
+ * Create a request handler that routes between API and static files.
+ * API routes are checked first, then health check, then static files.
+ */
+export function handleRequest(publicDir, projectRoot) {
+    const staticHandler = serveStatic(publicDir);
+    const apiHandler = createApiHandler(projectRoot);
+    return (req, res) => {
+        // Try API routes first (async)
+        apiHandler(req, res)
+            .then((handled) => {
+            if (handled)
+                return;
+            // Health check endpoint
+            if (req.url === "/api/health") {
+                res.writeHead(200, {
+                    "Content-Type": "application/json; charset=utf-8",
+                });
+                res.end(JSON.stringify({ ok: true, server: "twining-mcp" }));
+                return;
+            }
+            // Fall through to static file serving
+            return staticHandler(req, res);
+        })
+            .catch((err) => {
+            console.error("[twining] Request handler error:", err);
+            if (!res.headersSent) {
+                res.writeHead(500);
+                res.end("Internal Server Error");
+            }
+        });
+    };
+}
+/**
+ * Start the dashboard HTTP server.
+ * Returns the server and actual port, or null if the dashboard is disabled.
+ *
+ * @param projectRoot - The project root directory (used for API data access)
+ */
+export async function startDashboard(projectRoot) {
+    const config = getDashboardConfig();
+    if (!config.enabled) {
+        return null;
+    }
+    // Resolve public/ directory relative to this compiled file
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const publicDir = path.join(__dirname, "public");
+    const server = http.createServer(handleRequest(publicDir, projectRoot));
+    const port = await tryListen(server, config.port, 5);
+    const url = `http://127.0.0.1:${port}`;
+    console.error(`[twining] Dashboard: ${url}`);
+    // Auto-open browser (non-fatal on failure)
+    if (config.autoOpen) {
+        import("open")
+            .then((mod) => mod.default(url))
+            .catch(() => {
+            // open package unavailable or browser launch failed — not critical
+        });
+    }
+    return { server, port };
+}
+/**
+ * Register signal handlers for graceful dashboard shutdown.
+ * Closes the HTTP server on SIGTERM/SIGINT with a 3-second force-exit timeout.
+ */
+export function setupDashboardShutdown(httpServer) {
+    const shutdown = () => {
+        httpServer.close(() => {
+            // Server closed cleanly
+        });
+        // Force exit after 3 seconds if close hangs
+        const timer = setTimeout(() => {
+            process.exit(0);
+        }, 3000);
+        // Don't let the timer keep the process alive
+        if (timer.unref) {
+            timer.unref();
+        }
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+}
+//# sourceMappingURL=http-server.js.map

package/dist/dashboard/http-server.js.map

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