@jhizzard/termdeck 0.2.3 → 0.2.5

package/README.md

@@ -4,9 +4,7 @@
 
 A browser-based terminal multiplexer with an onboarding tour, rich per-panel metadata, and **Flashback** — automatic recall of similar past errors, surfaced the moment a panel hits a problem. No asking, no querying, no manual search. TermDeck notices you're stuck and offers the memory.
 
-![TermDeck dashboard — browser-based terminal multiplexer with per-panel metadata overlays](assets/hero.jpg)
-
-*(A fresh hero screenshot with a live Flashback toast is coming in v0.2.1 — see [docs/FOLLOWUP.md](docs/FOLLOWUP.md).)*
+![TermDeck Flashback in action — proactive memory recall on panel error, captured live against the production Supabase store](docs/screenshots/flashback-demo.gif)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"
@@ -24,6 +24,7 @@
     "dev": "node packages/server/src/index.js",
     "server": "node packages/server/src/index.js",
     "start": "NODE_ENV=production node packages/cli/src/index.js",
+    "test": "node --test packages/server/tests/**/*.test.js",
     "install:app": "bash install.sh"
   },
   "dependencies": {

package/packages/server/src/rag.js

@@ -41,7 +41,13 @@ class RAGIntegration {
         payload,
         project,
         timestamp: new Date().toISOString()
-      }).catch(() => {}); // Silent fail, sync will retry
+      }).catch((err) => {
+        // Non-fatal — the periodic sync loop will retry this event on its next
+        // tick because it's still marked unsynced in the outbox. Log at debug
+        // level so the first failure is visible in verbose logs without
+        // flooding stdout on routine transient errors.
+        console.debug('[mnestra] immediate push failed (sync loop will retry):', err && err.message);
+      });
     }
   }
 

package/packages/server/src/session.js

@@ -33,7 +33,16 @@ const PATTERNS = {
     django: /Starting development server/,
     httpServer: /Serving HTTP on/,
     request: /(?:^|\s|")(GET|POST|PUT|DELETE|PATCH)\s+\S+.*?\s(\d{3})/m,
-    port: /(?:port\s+(\d+)|(?:on|at)\s+(?:https?:\/\/)?[\w.\[\]:]*:(\d+))/i
+    // Port detection — matches any of:
+    //   • "port NNNN" phrase (capture group 1)
+    //   • URL with http/https scheme, optionally prefixed with "on " or "at "
+    //     (capture group 2)
+    //   • bare "on HOST:NNNN" or "at HOST:NNNN" even without a scheme
+    //     (capture group 2)
+    // Port must be 2–5 digits to avoid matching timestamps like "23:40".
+    // `_detectPort` reads `match[1] || match[2]`, so both capture groups
+    // are live.
+    port: /(?:\bport\s+(\d{2,5})\b|(?:https?:\/\/|\bon\s+|\bat\s+)[a-zA-Z0-9.\-_\[\]]+:(\d{2,5})\b)/i
   },
   shell: {
     prompt: /[\$#%❯>]\s*$/m,
@@ -370,16 +379,36 @@ class SessionManager {
     return Array.from(this.sessions.values()).map(s => s.toJSON());
   }
 
+  // Fields a client is allowed to modify via PATCH /api/sessions/:id.
+  // Explicit whitelist so a malicious or buggy client cannot inject
+  // arbitrary metadata (e.g. overwriting `pid`, `exitCode`, `lastCommands`,
+  // or mutating internal pattern state). Server-mutable fields like
+  // `status`, `lastActivity`, `detectedPort` are intentionally excluded —
+  // those are driven by the output analyzer, not the client.
+  static PATCHABLE_META_FIELDS = new Set([
+    'theme',
+    'label',
+    'project',
+    'ragEnabled',
+    'flashbackEnabled'
+  ]);
+
   updateMeta(id, updates) {
     const session = this.sessions.get(id);
     if (!session) return null;
+    if (!updates || typeof updates !== 'object') return session;
 
-    Object.assign(session.meta, updates);
+    const applied = {};
+    for (const [key, val] of Object.entries(updates)) {
+      if (!SessionManager.PATCHABLE_META_FIELDS.has(key)) continue;
+      session.meta[key] = val;
+      applied[key] = val;
+    }
 
     // Persist theme changes to SQLite
-    if (updates.theme && this.db) {
+    if (applied.theme && this.db) {
       this.db.prepare('UPDATE sessions SET theme = ? WHERE id = ?')
-        .run(updates.theme, id);
+        .run(applied.theme, id);
     }
 
     this._emit('session:updated', session);