@luanpdd/kit-mcp 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -6,6 +6,38 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning:
 
 ## [Unreleased]
 
+## [1.5.2] - 2026-05-05
+
+Patch de lifecycle: sidecar não desliga mais sozinho por idle.
+
+### Corrigido
+
+- **Sidecar encerrava sozinho após 30min** mesmo com a aba aberta sem eventos. Default de `idleMs` mudou de `30 * 60 * 1000` (30min) para `0` (nunca encerra). Resolve "abro a sidecar pra acompanhar trabalho longo, saio almoçar, volto e tá morta". Quem quiser o comportamento antigo: `kit ui start --idle-ms 1800000`.
+
+### Sem mudanças de API
+
+Patch isolado em `src/ui/server.js`. Stable API v1.0+ preservada.
+
+### Heads-up
+
+Se você tem `@luanpdd/kit-mcp` instalado globalmente (`npm i -g`) e `kit ui start` está dando "unknown command 'ui'", a versão global está stale. Atualize com `npm i -g @luanpdd/kit-mcp@latest`.
+
+## [1.5.1] - 2026-05-05
+
+Patch da UI sidecar: auto-reconnect quando o server reinicia + bordas com respiro.
+
+### Corrigido
+
+- **UI fica presa em "desconectado" quando server volta.** O `EventSource` nativo às vezes estagna no estado `CONNECTING` mesmo depois do server voltar — usuário precisava recarregar a aba. Agora um poll do `/healthz` a cada 3s roda em paralelo: ao detectar 200, fecha o `EventSource` antigo, hidrata `/state`, e abre um novo. Funciona pra qualquer cenário (kill -9, `kit ui stop` + `kit ui start`, network blip, máquina suspended). Usuário **não precisa mais recarregar** — basta o server voltar.
+
+- **Banner "Sidecar encerrou" persistia mesmo após reconnect.** Race entre o handler de shutdown e o poll de saúde podia deixar o banner visível mesmo com a conexão de volta. Agora `applyConnState("open")` sempre remove o banner — estado saudável significa que o aviso está stale.
+
+- **Cropping nas bordas da timeline:** "há 22m" colado na borda esquerda e `runId`/tokens-chip cortados na direita. `.tl-row` ganhou `padding: var(--pad-tight) 12px`. `.tl-time` virou `padding-right: 8px`. `.tl-content` ganhou `padding-right: 4px` + `overflow: hidden`. Tokens-chip e tl-runid agora têm `flex-shrink: 0` explícito pra não encolher quando a mensagem ocupa muita largura.
+
+### Sem mudanças de API
+
+Patch puro de UI. `src/ui/static/index.html` e `test/integration/ui-static.test.js` apenas. Stable API v1.0+ preservada.
+
 ## [1.5.0] - 2026-05-05
 
 UI sidecar — bug fixes visuais + tokens + histórico de sessão.

package/bin/ui.js

@@ -33,7 +33,7 @@ if (args.help) {
     'Usage: node bin/ui.js [options]',
     '  --project-root <path>   project root for lockfile keying (default: cwd)',
     '  --port <n>              bind to a specific port (default: auto-pick 7100-7199)',
-    '  --idle-ms <ms>          idle shutdown timeout (default: 1800000 = 30min; 0 = never)',
+    '  --idle-ms <ms>          idle shutdown timeout (default: 0 = never; pass e.g. 1800000 for 30min)',
     '  --version               print version and exit',
     '  --help                  this text',
     '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luanpdd/kit-mcp",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Generic infrastructure to ship YOUR personal kit of agents/commands/skills as an MCP server, with cross-IDE sync (Claude Code, Cursor, Codex, Gemini, Windsurf, Antigravity, Copilot, Trae).",
   "type": "module",
   "bin": {

package/src/cli/index.js

@@ -379,7 +379,7 @@ ui.command('start')
   .description('Start the sidecar HTTP server in foreground (Ctrl+C to stop). Prints URL on stderr.')
   .option('--project-root <path>', 'Project root for lockfile keying (default: cwd)')
   .option('--port <n>', 'Bind to a specific port (default: auto-pick 7100-7199)')
-  .option('--idle-ms <ms>', 'Idle shutdown timeout (default 30min; 0 = never)')
+  .option('--idle-ms <ms>', 'Idle shutdown timeout (default 0 = never; e.g. 1800000 for 30min)')
   .option('--no-open', 'Skip auto-opening the browser')
   .action(async (opts) => {
     const projectRoot = opts.projectRoot || process.cwd();

package/src/ui/server.js

@@ -33,7 +33,7 @@ const HOST = '127.0.0.1';
 const HEARTBEAT_INTERVAL_MS = 15_000;
 const RING_BUFFER_SIZE = 200;
 const MAX_SSE_SUBSCRIBERS = 32;
-const DEFAULT_IDLE_MS = 30 * 60 * 1000; // 30 minutes
+const DEFAULT_IDLE_MS = 0; // never auto-shutdown by default — pass --idle-ms 1800000 to opt back in
 
 const SSE_HEADERS = {
   'Content-Type': 'text/event-stream; charset=utf-8',

package/src/ui/static/index.html

@@ -483,9 +483,9 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 
 .tl-row {
   display: grid;
-  grid-template-columns: 64px 18px 1fr;
+  grid-template-columns: 64px 18px minmax(0, 1fr);
   gap: 0;
-  padding: var(--pad-tight) 0;
+  padding: var(--pad-tight) 12px;
   position: relative;
   border-radius: 4px;
   transition: background .15s var(--ease);
@@ -514,8 +514,9 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
   font-size: 11px;
   color: var(--text-3);
   font-variant-numeric: tabular-nums;
-  padding-left: 4px;
   padding-top: 1px;
+  padding-right: 8px;
+  text-align: left;
 }
 
 /* rail with node */
@@ -552,14 +553,17 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 .tl-row[data-type="progress"] .tl-node { width: 5px; height: 5px; margin-top: 6px; }
 
 /* group runId connector — visually subtle indent */
-.tl-row[data-grouped="true"] { padding-left: 0; }
 .tl-row[data-grouped="true"] .tl-node { background: var(--text-3); }
 
 .tl-content {
   display: flex; align-items: baseline; gap: 8px;
   padding-left: 8px;
+  padding-right: 4px;
   min-width: 0;
+  overflow: hidden;
 }
+.tl-content > .tokens-chip,
+.tl-content > .tl-runid { flex-shrink: 0; }
 
 .tl-badge {
   font-family: var(--mono);
@@ -1846,6 +1850,12 @@ function applyConnState(s) {
     els.conn.dataset.state = "on";
     els.connLabel.textContent = "conectado";
     if (els.srcLabel) els.srcLabel.textContent = "ao vivo";
+    // Healthy => banner stale. Independente de qual caminho colocou ele lá
+    // (shutdown event antigo, race, hydrate trazendo shutdown histórico),
+    // estar conectado significa que o aviso "Reabra com kit ui start" não
+    // serve mais — remova sempre.
+    const banner = document.getElementById("shutdown-banner");
+    if (banner) banner.remove();
   } else if (s === "connecting") {
     els.conn.dataset.state = "off";
     els.connLabel.textContent = "conectando";
@@ -1893,11 +1903,16 @@ function connectRealSource() {
   evtSource.addEventListener("open", () => {
     lastConnectedAt = Date.now();
     applyConnState("open");
+    stopHealthPoll();    // já tá conectado, não precisa pollar
   });
 
   evtSource.addEventListener("error", () => {
-    // EventSource auto-retries; reflect "closed" until next open fires.
+    // EventSource auto-retries; nós só atualizamos o estado visível e iniciamos
+    // o poll-de-saúde paralelo, que cobre o caso "server reiniciou" — o native
+    // retry às vezes gruda em CONNECTING sem nunca virar OPEN, e o poll detecta
+    // quando o /healthz volta a responder e força um connectRealSource() limpo.
     applyConnState("closed");
+    startHealthPoll();
   });
 
   // Listen for each typed event the server emits.
@@ -1907,6 +1922,9 @@ function connectRealSource() {
       if (data && data.type === "shutdown") {
         applyConnState("shutdown");
         showShutdownBanner();
+        // Mesmo após shutdown, um novo `kit ui start` faz o server voltar.
+        // Continue tentando reconectar — usuário não precisa recarregar a aba.
+        startHealthPoll();
       }
       ingest(data);
     } catch (_) { /* swallow malformed */ }
@@ -1917,12 +1935,41 @@ function connectRealSource() {
   evtSource.onmessage = handler; // fallback for unnamed
 }
 
-/* Background-tab recovery — Chrome throttles timers in inactive tabs and the
-   native EventSource retry can stall. When the tab becomes visible again and
-   we know we're closed, force a fresh hydrate + reconnect. */
+/* ───────────────────── health-poll auto-reconnect ─────────────────────
+   Quando o EventSource cai e fica preso (server reiniciado, sidecar `kit ui
+   stop` seguido de `kit ui start`, network blip), o native retry pode estagnar
+   em CONNECTING. Esse poll roda em segundo plano em paralelo: quando o /healthz
+   volta a responder 200, fechamos o EventSource antigo, hidratamos /state, e
+   abrimos um novo. Para de pollar assim que conectamos com sucesso. */
+let healthPollTimer = null;
+function startHealthPoll() {
+  if (healthPollTimer) return;
+  healthPollTimer = setInterval(async () => {
+    if (els.conn.dataset.state === "on") { stopHealthPoll(); return; }
+    try {
+      const res = await fetch("/healthz", { credentials: "omit", cache: "no-store" });
+      if (res.ok) {
+        stopHealthPoll();
+        // Banner de shutdown é stale agora que o server voltou — remova.
+        const banner = document.getElementById("shutdown-banner");
+        if (banner) banner.remove();
+        await hydrateFromState();
+        connectRealSource();
+      }
+    } catch (_) { /* server ainda não voltou — keep tentando */ }
+  }, 3000);
+}
+function stopHealthPoll() {
+  if (healthPollTimer) { clearInterval(healthPollTimer); healthPollTimer = null; }
+}
+
+/* Background-tab recovery — quando o tab volta a ficar visível e estamos fora
+   do estado conectado, força um reconnect imediato em vez de esperar o próximo
+   tick de health poll. */
 document.addEventListener("visibilitychange", () => {
   if (document.visibilityState !== "visible") return;
-  if (els.conn.dataset.state === "off") {
+  if (els.conn.dataset.state !== "on") {
+    stopHealthPoll();
     hydrateFromState().then(connectRealSource);
   }
 });