@jhizzard/termdeck 0.3.2 → 0.3.3

package/README.md

@@ -22,6 +22,16 @@ Enabling Flashback takes **one additional 15-minute setup step** — see Tier 2
 
 ---
 
+## Documentation hierarchy
+
+- **This README** — quickstart, pitch, and links
+- **[docs/GETTING-STARTED.md](docs/GETTING-STARTED.md)** — full 4-tier installation guide
+- **[termdeck-docs.vercel.app](https://termdeck-docs.vercel.app)** — reference docs (Astro/Starlight)
+- **docs/launch/** — launch collateral (Show HN, Twitter, etc.)
+- **docs/sprint-N-*/** — historical sprint logs (append-only, not maintained post-sprint)
+
+---
+
 ## How Flashback works
 
 When a panel's status transitions to `errored`, the server's output analyzer fires an event. The mnestra bridge takes the session context (type, project, last command, error tail) and queries your Mnestra memory store for the top similar match. If it finds one above the relevance threshold, the result is pushed to the panel's WebSocket as a `proactive_memory` message. The client renders it as a toast anchored to the panel, showing the match's project tag, source type, similarity score, and content snippet. You click the toast to expand into the Memory tab of that panel's drawer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"

package/packages/client/public/style.css

@@ -39,17 +39,27 @@
       display: flex;
       align-items: center;
       justify-content: space-between;
-      padding: 0 16px;
+      gap: 10px;
+      padding: 0 12px;
       height: 42px;
       background: var(--tg-surface);
       border-bottom: 1px solid var(--tg-border);
       flex-shrink: 0;
+      overflow-x: auto;
+      overflow-y: hidden;
+      min-width: 0;
+      scrollbar-width: thin;
+      flex-wrap: nowrap;
     }
 
+    .topbar::-webkit-scrollbar { height: 4px; }
+    .topbar::-webkit-scrollbar-thumb { background: var(--tg-border); border-radius: 2px; }
+
     .topbar-left {
       display: flex;
       align-items: center;
       gap: 12px;
+      flex-shrink: 0;
     }
 
     .topbar-logo {
@@ -66,7 +76,7 @@
 
     .topbar-stats {
       display: flex;
-      gap: 16px;
+      gap: 10px;
       font-size: 11px;
       color: var(--tg-text-dim);
     }
@@ -84,6 +94,7 @@
       background: var(--tg-bg);
       padding: 3px;
       border-radius: var(--tg-radius-sm);
+      flex-shrink: 0;
     }
 
     .layout-btn {
@@ -104,7 +115,8 @@
     .topbar-right {
       display: flex;
       align-items: center;
-      gap: 8px;
+      gap: 4px;
+      flex-shrink: 0;
     }
 
     .topbar-right button {
@@ -112,7 +124,7 @@
       border: 1px solid var(--tg-border);
       color: var(--tg-text-dim);
       font-size: 11px;
-      padding: 4px 12px;
+      padding: 4px 8px;
       border-radius: var(--tg-radius-sm);
       cursor: pointer;
       font-family: var(--tg-sans);

package/packages/server/src/index.js

@@ -20,9 +20,17 @@ try { pg = require('pg'); } catch { pg = null; }
 // servers without DATABASE_URL never pay the connection cost.
 let _rumenPool = null;
 let _rumenPoolFailed = false;
+let _rumenPoolFailedAt = 0;
+const RUMEN_POOL_RETRY_MS = 30_000;
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function getRumenPool() {
-  if (_rumenPool || _rumenPoolFailed) return _rumenPool;
+  if (_rumenPool) return _rumenPool;
+  if (_rumenPoolFailed) {
+    if (Date.now() - _rumenPoolFailedAt < RUMEN_POOL_RETRY_MS) return null;
+    console.warn('[rumen] retrying pool creation after 30s cooldown');
+    _rumenPoolFailed = false;
+    _rumenPoolFailedAt = 0;
+  }
   if (!pg || !process.env.DATABASE_URL) return null;
   try {
     _rumenPool = new pg.Pool({
@@ -38,6 +46,7 @@ function getRumenPool() {
   } catch (err) {
     console.warn('[rumen] failed to create pg pool:', err.message);
     _rumenPoolFailed = true;
+    _rumenPoolFailedAt = Date.now();
     return null;
   }
 }

package/packages/server/src/preflight.js

@@ -23,12 +23,12 @@ const CACHE_TTL_MS = 60_000;
 async function checkMnestra(config) {
   const rag = config.rag || {};
   const url = rag.mnestraWebhookUrl
-    ? rag.mnestraWebhookUrl.replace(/\/mnestra\/?$/, '/health')
-    : 'http://localhost:37778/health';
+    ? rag.mnestraWebhookUrl.replace(/\/mnestra\/?$/, '/healthz')
+    : 'http://localhost:37778/healthz';
 
   const body = await httpGet(url, 3000);
   const data = tryParseJSON(body);
-  const total = data && (data.total || data.memories || data.count);
+  const total = data && (data.store?.rows ?? data.total ?? data.memories ?? data.count ?? null);
   if (total != null) {
     return { name: 'mnestra_reachable', passed: true, detail: `${Number(total).toLocaleString()} memories` };
   }
@@ -45,9 +45,9 @@ async function checkMnestraMemories(config) {
     ? rag.mnestraWebhookUrl.replace(/\/mnestra\/?$/, '')
     : 'http://localhost:37778';
 
-  const body = await httpGet(`${baseUrl}/health`, 3000);
+  const body = await httpGet(`${baseUrl}/healthz`, 3000);
   const data = tryParseJSON(body);
-  const total = data && (data.total || data.memories || data.count);
+  const total = data && (data.store?.rows ?? data.total ?? data.memories ?? data.count ?? null);
   if (total != null && Number(total) > 0) {
     return { name: 'mnestra_has_memories', passed: true, detail: `${Number(total).toLocaleString()} memories loaded` };
   }