contactsheet 0.1.3 → 0.1.5

package/dist/canvas/style.css

@@ -1187,3 +1187,34 @@ body:not([data-sidebar="off"]) #cs-hud { left: calc(var(--cs-sb-w) + 16px); }
   box-shadow: 0 0 0 3px var(--cs-accent), 0 0 0 6px var(--cs-accent-32);
   z-index: 4;
 }
+
+/* ---------- dev server 僵死横幅(全局,盖在一切之上但不拦事件之外的区域) ---------- */
+.cs-health {
+  position: fixed;
+  top: 12px;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: var(--cs-z-overlay);
+  display: flex;
+  align-items: baseline;
+  gap: var(--cs-sp-4);
+  max-width: min(720px, 86vw);
+  padding: var(--cs-sp-4) var(--cs-sp-6);
+  border: 1px solid var(--cs-danger);
+  border-radius: var(--cs-r-3);
+  background: color-mix(in srgb, var(--cs-danger) 12%, var(--cs-s1));
+  color: var(--cs-fg);
+  font: var(--cs-fs-sm)/1.5 var(--cs-ff-sans);
+  box-shadow: var(--cs-e3);
+  /* 入场:@starting-style 由 transition 接住,无 JS 时序(MOTION-013);进入用 ease-out(MOTION-006) */
+  transition: opacity var(--cs-dur-3) var(--cs-ease-out), translate var(--cs-dur-3) var(--cs-ease-out);
+}
+@starting-style {
+  .cs-health { opacity: 0; translate: 0 -8px; }
+}
+.cs-health b { color: var(--cs-danger); font-weight: var(--cs-fw-bold); white-space: nowrap; }
+.cs-health span { color: var(--cs-fg-2); }
+@media (prefers-reduced-motion: reduce) {
+  .cs-health { transition: opacity var(--cs-dur-3) var(--cs-ease-out); }
+  @starting-style { .cs-health { translate: none; } }
+}

package/dist/cli.js

@@ -1147,6 +1147,56 @@ async function pushToSession(cfg, text2, pid) {
   return { ok: true, pid: target.pid, name: target.name };
 }
 
+// src/server/health.ts
+var INTERVAL_MS = Number(process.env.CS_HEALTH_INTERVAL_MS ?? 2e4);
+var TIMEOUT_MS = Number(process.env.CS_HEALTH_TIMEOUT_MS ?? 1e4);
+var FAILS_TO_TRIP = 2;
+var current = { ok: true };
+function currentHealth() {
+  return current;
+}
+function startHealthMonitor(cfg, broadcast2) {
+  let fails = 0;
+  let everOk = false;
+  let timer = null;
+  const probe = async () => {
+    let failDetail = null;
+    try {
+      const r = await fetch(`${cfg.target}/__cs/registry`, { signal: AbortSignal.timeout(TIMEOUT_MS) });
+      if (r.ok || r.status === 404) {
+        everOk = true;
+        fails = 0;
+        if (!current.ok) {
+          current = { ok: true, lastOkAt: Date.now() };
+          broadcast2({ type: "health", ok: true });
+        } else {
+          current = { ok: true, lastOkAt: Date.now() };
+        }
+        return;
+      }
+      failDetail = `SSR \u63A2\u6D4B\u8FD4\u56DE HTTP ${r.status}`;
+    } catch (err) {
+      const e = err;
+      failDetail = e.name === "TimeoutError" ? `SSR \u63A2\u6D4B ${TIMEOUT_MS / 1e3}s \u65E0\u54CD\u5E94` : `\u8FDE\u4E0D\u4E0A(${e.cause?.code ?? "network"})`;
+    }
+    if (!everOk) return;
+    fails++;
+    if (fails >= FAILS_TO_TRIP && current.ok) {
+      current = { ok: false, detail: failDetail ?? "\u672A\u77E5", lastOkAt: current.lastOkAt };
+      broadcast2({ type: "health", ok: false, detail: current.detail });
+      console.warn(`[contactsheet] \u26A0 \u76EE\u6807 ${cfg.target} \u7591\u4F3C\u50F5\u6B7B:${current.detail}(\u9759\u6001\u53EF\u80FD\u4ECD 200)\u3002\u753B\u5E03\u5DF2\u6302\u6A2A\u5E45\u3002`);
+    }
+  };
+  timer = setInterval(() => void probe(), INTERVAL_MS);
+  timer.unref();
+  void probe();
+  return {
+    close() {
+      if (timer) clearInterval(timer);
+    }
+  };
+}
+
 // src/server/sse.ts
 var clients = /* @__PURE__ */ new Set();
 var heartbeat = null;
@@ -1383,6 +1433,10 @@ async function handleApi(cfg, req, res, pathname) {
     const rel = await saveRef(cfg, body.name || "ref.png", body.dataBase64);
     return sendJson(res, 200, { path: rel });
   }
+  if (pathname === "/__cs/api/health") {
+    if (method !== "GET") return sendText(res, 405, "method not allowed");
+    return sendJson(res, 200, currentHealth());
+  }
   if (pathname === "/__cs/api/context") {
     if (method !== "GET") return sendText(res, 405, "method not allowed");
     try {
@@ -1559,6 +1613,11 @@ async function startServer(cfg) {
       res.destroy();
     }
   });
+  proxy.on("proxyReq", (proxyReq, _req, res) => {
+    res.on("close", () => {
+      if (!res.writableEnded) proxyReq.destroy();
+    });
+  });
   proxy.on("proxyRes", () => proxyLog.alive());
   proxy.on("open", () => proxyLog.alive());
   let mcp = null;
@@ -1581,18 +1640,30 @@ async function startServer(cfg) {
     s.on("close", () => sockets.delete(s));
   });
   const host = cfg.host ?? "127.0.0.1";
-  const port = await listenWithFallback(server, cfg, host);
+  let twin = null;
+  const port = await listenWithFallback(server, cfg, host, (t) => {
+    twin = t;
+    t.on("connection", (sock) => {
+      sockets.add(sock);
+      sock.on("close", () => sockets.delete(sock));
+    });
+  });
   if (host !== "127.0.0.1" && host !== "localhost") {
     console.warn(
       warn(`\u76D1\u542C\u5728 ${host}:${port} \u2014\u2014 \u753B\u5E03\u65E0\u9274\u6743,\u540C\u7F51\u7EDC\u7684\u4EFB\u4F55\u4EBA\u90FD\u80FD\u8BFB\u4F60\u7684\u6279\u6CE8\u3001\u5E76\u5411\u4F60\u7684 Claude Code \u4F1A\u8BDD\u63A8\u9001\u6D88\u606F\u3002\u53EA\u5728\u53EF\u4FE1\u7F51\u7EDC\u8FD9\u4E48\u505A\u3002`)
     );
   }
+  const health = startHealthMonitor(cfg, broadcast);
   return {
     port,
     async close() {
+      health.close();
       closeAll();
       proxyLog.close();
       proxy.close();
+      if (twin) {
+        await new Promise((r) => twin.close(() => r()));
+      }
       await new Promise((resolve2) => {
         const fallback = setTimeout(resolve2, 2e3);
         for (const s of sockets) s.destroy();
@@ -1674,18 +1745,34 @@ async function occupiedBySameProject(cfg, port) {
     return false;
   }
 }
-async function listenWithFallback(server, cfg, host) {
-  const tryListen = (port) => new Promise((resolve2, reject) => {
+async function listenWithFallback(server, cfg, host, onTwin) {
+  const listenOnce = (srv, port, h) => new Promise((resolve2, reject) => {
     const onErr = (err) => {
-      if (err.code === "EADDRINUSE") resolve2(false);
+      if (err.code === "EADDRINUSE") resolve2("busy");
+      else if (err.code === "EADDRNOTAVAIL" || err.code === "EAFNOSUPPORT") resolve2("nofam");
       else reject(err);
     };
-    server.once("error", onErr);
-    server.listen(port, host, () => {
-      server.off("error", onErr);
-      resolve2(true);
+    srv.once("error", onErr);
+    srv.listen(port, h, () => {
+      srv.off("error", onErr);
+      resolve2("ok");
     });
   });
+  const tryListen = async (port) => {
+    const main2 = await listenOnce(server, port, host);
+    if (main2 !== "ok") return false;
+    if (host !== "127.0.0.1") return true;
+    const t = http.createServer(server.listeners("request")[0]);
+    for (const l of server.listeners("upgrade")) t.on("upgrade", l);
+    const r = await listenOnce(t, port, "::1");
+    if (r === "ok") {
+      onTwin(t);
+      return true;
+    }
+    if (r === "nofam") return true;
+    await new Promise((res) => server.close(() => res()));
+    return false;
+  };
   if (await tryListen(cfg.port)) return cfg.port;
   if (await occupiedBySameProject(cfg, cfg.port)) {
     console.log(