hotsheet 0.17.0-beta.21 → 0.17.0-beta.23

package/dist/channel.js

@@ -34708,6 +34708,40 @@ function slugifyDataDir(dataDir2) {
   return slug !== "" ? slug : "project";
 }
 
+// src/channelLog.ts
+import { appendFileSync, renameSync, statSync } from "fs";
+var CHANNEL_LOG_MAX_BYTES = 1048576;
+function createChannelLogger(logPath) {
+  let injectedBlankLine = false;
+  return {
+    log(event, details) {
+      try {
+        const size = safeStatSize(logPath);
+        if (size >= CHANNEL_LOG_MAX_BYTES) {
+          try {
+            renameSync(logPath, `${logPath}.old`);
+          } catch {
+          }
+        }
+        const ts = (/* @__PURE__ */ new Date()).toISOString();
+        const detailsText = details === void 0 || details === "" ? "" : ` ${details}`;
+        const prefix = !injectedBlankLine && size > 0 ? "\n" : "";
+        injectedBlankLine = true;
+        appendFileSync(logPath, `${prefix}[${ts}] [pid ${process.pid}] ${event}:${detailsText}
+`, "utf-8");
+      } catch {
+      }
+    }
+  };
+}
+function safeStatSize(path) {
+  try {
+    return statSync(path).size;
+  } catch {
+    return 0;
+  }
+}
+
 // src/channelPermissions.ts
 var PERMISSION_TTL_MS = 12e4;
 var queue = [];
@@ -34731,6 +34765,48 @@ function clearAllPermissions() {
   queue.length = 0;
 }
 
+// src/channelStdioWatcher.ts
+function installStdioDisconnectHandler(opts) {
+  const { stdin, stdout, onDisconnect, log } = opts;
+  let fired = false;
+  const fire = (reason) => {
+    if (fired) return;
+    fired = true;
+    if (log !== void 0) {
+      log(`stdio disconnected (${reason}) \u2014 triggering channel-server cleanup`);
+    }
+    try {
+      onDisconnect(reason);
+    } catch (err) {
+      if (log !== void 0) {
+        log(`onDisconnect threw: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  };
+  const onStdinEnd = () => {
+    fire("stdin-end");
+  };
+  const onStdinClose = () => {
+    fire("stdin-close");
+  };
+  const onStdoutError = (err) => {
+    if (err.code === "EPIPE" || err.code === "ECONNRESET" || err.code === "ECANCELED") {
+      fire("stdout-error");
+    }
+  };
+  stdin.on("end", onStdinEnd);
+  stdin.on("close", onStdinClose);
+  stdout.on("error", onStdoutError);
+  let disposed = false;
+  return () => {
+    if (disposed) return;
+    disposed = true;
+    stdin.off("end", onStdinEnd);
+    stdin.off("close", onStdinClose);
+    stdout.off("error", onStdoutError);
+  };
+}
+
 // src/channel.ts
 var CHANNEL_VERSION = 7;
 var dataDir = ".hotsheet";
@@ -34744,6 +34820,8 @@ for (let i = 0; i < args.length; i++) {
 var portFile = join3(dataDir, "channel-port");
 var serverSlug = slugifyDataDir(dataDir);
 var serverName = `hotsheet-channel-${serverSlug}`;
+var channelLog = createChannelLogger(join3(dataDir, "mcp.log"));
+channelLog.log("process-start", `argv=${process.argv.slice(2).join(" ")} dataDir=${dataDir} serverName=${serverName}`);
 var mcp = new Server(
   { name: serverName, version: "0.1.0" },
   {
@@ -34774,10 +34852,25 @@ mcp.setRequestHandler(ListToolsRequestSchema, () => {
 });
 mcp.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args2 } = request.params;
+  channelLog.log("tools/call", `name=${name}`);
   const result = await callTool(name, args2 ?? {}, dataDir);
   return result;
 });
 await mcp.connect(new StdioServerTransport());
+channelLog.log("mcp-connect", "StdioServerTransport ready");
+installStdioDisconnectHandler({
+  stdin: process.stdin,
+  stdout: process.stdout,
+  log: (msg) => {
+    process.stderr.write(`${serverName}: ${msg}
+`);
+    channelLog.log("stdio-watcher", msg);
+  },
+  onDisconnect: (reason) => {
+    channelLog.log("disconnect", `reason=${reason} \u2014 invoking cleanup`);
+    void cleanup(`stdio-${reason}`);
+  }
+});
 var PermissionRequestSchema = external_exports3.object({
   method: external_exports3.literal("notifications/claude/channel/permission_request"),
   params: external_exports3.object({
@@ -34921,6 +35014,7 @@ var httpServer = createServer(async (req, res) => {
       }
       body += String(chunk);
     }
+    channelLog.log("trigger", `bodyBytes=${body.length}`);
     try {
       await mcp.notification({
         method: "notifications/claude/channel",
@@ -34932,6 +35026,7 @@ var httpServer = createServer(async (req, res) => {
       res.writeHead(200, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ ok: true }));
     } catch (err) {
+      channelLog.log("trigger-error", String(err));
       res.writeHead(500, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ error: String(err) }));
     }
@@ -34983,10 +35078,18 @@ httpServer.listen(0, "127.0.0.1", () => {
     }
     process.stderr.write(`${serverName} listening on port ${port}
 `);
+    channelLog.log("http-listen", `port=${port}`);
     void notifyMainServer();
   }
 });
-async function cleanup() {
+var heartbeatInterval = setInterval(() => {
+  const mem = process.memoryUsage();
+  channelLog.log("heartbeat", `uptime=${process.uptime().toFixed(1)}s rss=${(mem.rss / 1024 / 1024).toFixed(1)}MiB`);
+}, 6e4);
+heartbeatInterval.unref();
+async function cleanup(reason = "unspecified") {
+  channelLog.log("cleanup-start", `reason=${reason}`);
+  clearInterval(heartbeatInterval);
   try {
     unlinkSync(portFile);
   } catch {
@@ -34997,11 +35100,23 @@ async function cleanup() {
     await notifyMainServer(controller.signal);
   } catch {
   }
+  channelLog.log("cleanup-end", `reason=${reason} \u2014 exiting`);
   process.exit(0);
 }
-process.on("SIGTERM", () => void cleanup());
-process.on("SIGINT", () => void cleanup());
-process.on("exit", () => {
+process.on("SIGTERM", () => {
+  channelLog.log("signal", "SIGTERM");
+  void cleanup("SIGTERM");
+});
+process.on("SIGINT", () => {
+  channelLog.log("signal", "SIGINT");
+  void cleanup("SIGINT");
+});
+process.on("SIGHUP", () => {
+  channelLog.log("signal", "SIGHUP");
+  void cleanup("SIGHUP");
+});
+process.on("exit", (code) => {
+  channelLog.log("exit", `code=${code}`);
   try {
     unlinkSync(portFile);
   } catch {

package/dist/cli.js

@@ -21039,7 +21039,15 @@ var init_global_config = __esm({
       // HS-8290 — terminal-dashboard settings (formerly stored per-project but
       // are inherently cross-project since the dashboard shows tiles for every
       // registered project in one view). See docs/39-visibility-groupings.md.
-      dashboard: DashboardConfigSchema2.optional()
+      dashboard: DashboardConfigSchema2.optional(),
+      // HS-8446 — global diagnostics opt-in. When true, the slow-server
+      // banner (HS-8175 / HS-8226) is allowed to surface AND the HS-8054
+      // UI-hang toast fires. Default false so the noisier diagnostic
+      // surfaces stay opt-in across every project on this machine. The
+      // freeze-log entries (`<dataDir>/freeze.log`) and the server-side
+      // event-loop heartbeat continue to fire regardless — the gate only
+      // suppresses the in-window UI surfaces.
+      diagnosticsEnabled: external_exports.boolean().optional()
     }).strict();
   }
 });
@@ -27276,14 +27284,17 @@ pageRoutes.get("/", (c) => {
             ] })
           ] }) }),
           /* @__PURE__ */ jsx("div", { className: "settings-section", style: "margin-top:16px", children: [
-            /* @__PURE__ */ jsx("div", { className: "settings-section-header", children: /* @__PURE__ */ jsx("h3", { children: "Diagnostics" }) }),
+            /* @__PURE__ */ jsx("div", { className: "settings-section-header", children: /* @__PURE__ */ jsx("h3", { children: [
+              "Diagnostics ",
+              /* @__PURE__ */ jsx("span", { className: "global-setting-badge", title: "This setting applies to every project on this machine.", children: "Global Setting" })
+            ] }) }),
             /* @__PURE__ */ jsx("div", { className: "settings-field settings-field-checkbox", children: [
               /* @__PURE__ */ jsx("label", { children: [
-                /* @__PURE__ */ jsx("input", { type: "checkbox", id: "settings-diagnostics-freeze-toast" }),
-                " Show UI-hang toast when freezes are detected"
+                /* @__PURE__ */ jsx("input", { type: "checkbox", id: "settings-diagnostics-enabled" }),
+                " Enable diagnostic UI surfaces (slow-server banner + UI-hang toast)"
               ] }),
               /* @__PURE__ */ jsx("span", { className: "settings-hint", children: [
-                "When on, a small toast pops in for each \u2265 500 ms UI hang the HS-8054 longtask observer catches (rate-limited to once every 10 s). Off by default. Freezes are always logged to ",
+                "When on, the slow-server banner (HS-8175 / HS-8226) surfaces when an HTTP request stays in flight past 3 s, and the HS-8054 longtask observer emits a small toast for each \u2265 500 ms UI hang (rate-limited to once every 10 s). Off by default \u2014 both surfaces are primarily useful when actively investigating event-loop blocks. Freezes are always logged to ",
                 /* @__PURE__ */ jsx("code", { children: "<dataDir>/freeze.log" }),
                 " for diagnostics regardless of this setting."
               ] })