@jhizzard/termdeck 0.4.2 → 0.4.3

package/README.md

@@ -139,7 +139,7 @@ Restart Claude Code. Six MCP tools appear: `memory_remember`, `memory_recall`, `
 
 ### Tier 3 — Add Rumen for async learning
 
-Rumen is a separate npm package — `@jhizzard/rumen@0.4.2` — that ships as a Supabase Edge Function designed to run on a 15-minute `pg_cron` schedule. It's the async reflection layer over Mnestra: it reads recent session memories, cross-references them with your entire historical corpus via hybrid search, synthesizes insights via Claude Haiku, and writes the results back into `rumen_insights` (a new table alongside Mnestra's `memory_items`). TermDeck's Flashback and Claude Code's `memory_recall` both automatically benefit because insights flow back into the same database.
+Rumen is a separate npm package — `@jhizzard/rumen@0.4.3` — that ships as a Supabase Edge Function designed to run on a 15-minute `pg_cron` schedule. It's the async reflection layer over Mnestra: it reads recent session memories, cross-references them with your entire historical corpus via hybrid search, synthesizes insights via Claude Haiku, and writes the results back into `rumen_insights` (a new table alongside Mnestra's `memory_items`). TermDeck's Flashback and Claude Code's `memory_recall` both automatically benefit because insights flow back into the same database.
 
 **Rumen is live.** First full-kickstart run against a production Mnestra store on 2026-04-15 19:47 UTC: **111 sessions processed, 111 insights generated** in one pass. Insights surfaced patterns like "the error detection regex in Flashback misses `No such file or directory` — same class of blind spot as X" and "Practice sessions exist as a separate model but frontend components were built and never wired into the schedule view." The cognitive loop is closed.
 
@@ -163,7 +163,7 @@ Honest limits, stated upfront so the skeptic has nothing to chase:
 - **Not a replacement for reading docs.** It's the shortest path to a memory you already wrote. If the memory isn't there, the feature does nothing.
 - **Not fully local by default.** Tier 2+ reaches out to Supabase for storage and OpenAI for embeddings. Tier 1 is fully local. A fully-local Tier 2 (local Postgres + local embeddings) is on the roadmap.
 - **Not free forever.** Tier 2+ pays OpenAI fractions of a cent per memory for embeddings. Self-hosted embeddings via Ollama are on the roadmap.
-- **Not proven at scale.** v0.4.2, validated against 3,527 memories in one developer's production store. First full Rumen kickstart on 2026-04-15 processed 111 sessions into 111 insights in one pass. No multi-user data yet. Bug reports and issues welcome.
+- **Not proven at scale.** v0.4.3, validated against 3,527 memories in one developer's production store. First full Rumen kickstart on 2026-04-15 processed 111 sessions into 111 insights in one pass. No multi-user data yet. Bug reports and issues welcome.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.4.2",
+  "version": "0.4.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/server/src/index.js

@@ -375,6 +375,7 @@ function createServer(config) {
         // configured, regardless of the push-loop flag.
         session.onErrorDetected = (sess, ctx) => {
           const question = `${sess.meta.type} error ${ctx.lastCommand || ''} ${ctx.tail || ''}`.trim();
+          console.log(`[flashback] error detected in session ${sess.id} (type=${sess.meta.type}, project=${sess.meta.project || 'none'}), querying Mnestra via ${mnestraBridge.mode}…`);
           mnestraBridge.queryMnestra({
             question,
             project: sess.meta.project,
@@ -386,16 +387,26 @@ function createServer(config) {
               status: 'errored'
             }
           }).then((result) => {
+            const count = (result.memories || []).length;
+            console.log(`[flashback] query returned ${count} matches for session ${sess.id}`);
             const hit = (result.memories || [])[0];
-            if (!hit) return;
+            if (!hit) {
+              console.log(`[flashback] no matches — skipping proactive_memory send for session ${sess.id}`);
+              return;
+            }
             if (sess.ws && sess.ws.readyState === 1) {
               try {
                 sess.ws.send(JSON.stringify({ type: 'proactive_memory', hit }));
+                console.log(`[flashback] proactive_memory sent to session ${sess.id} (source_type=${hit.source_type}, project=${hit.project})`);
               } catch (err) {
+                console.error('[flashback] proactive_memory send failed:', err);
                 console.error('[ws] proactive_memory send failed:', err);
               }
+            } else {
+              console.log(`[flashback] ws not open for session ${sess.id} (readyState=${sess.ws ? sess.ws.readyState : 'null'}) — dropped hit`);
             }
           }).catch((err) => {
+            console.error(`[flashback] query failed for session ${sess.id}: ${err.message}`);
             console.warn('[mnestra-bridge] proactive query failed:', err.message);
           });
         };

package/packages/server/src/mnestra-bridge/index.js

@@ -47,6 +47,24 @@ function createBridge(config) {
     const embeddingData = await embeddingRes.json();
     const embedding = embeddingData.data[0].embedding;
 
+    // NOTE: memory_hybrid_search (migrations/004) accepts exactly 8 named params:
+    //   query_text, query_embedding, match_count, full_text_weight,
+    //   semantic_weight, rrf_k, filter_project, filter_source_type.
+    // PostgREST matches RPC functions by the set of JSON keys in the body — any
+    // extra key (e.g. recency_weight, decay_days) makes it fail to resolve the
+    // overload and return 404 "Could not find the function". That was silently
+    // killing every Flashback query for 15 sprints.
+    const rpcBody = {
+      query_text: question,
+      query_embedding: `[${embedding.join(',')}]`,
+      match_count: 10,
+      full_text_weight: 1.0,
+      semantic_weight: 1.0,
+      rrf_k: 60,
+      filter_project: searchAll ? null : (project || null),
+      filter_source_type: null
+    };
+    console.log(`[flashback] direct RPC → memory_hybrid_search project=${rpcBody.filter_project ?? 'ALL'} q="${question.slice(0, 60)}"`);
     const searchRes = await fetch(`${supabaseUrl}/rest/v1/rpc/memory_hybrid_search`, {
       method: 'POST',
       headers: {
@@ -54,31 +72,23 @@ function createBridge(config) {
         'apikey': supabaseKey,
         'Authorization': `Bearer ${supabaseKey}`
       },
-      body: JSON.stringify({
-        query_text: question,
-        query_embedding: `[${embedding.join(',')}]`,
-        match_count: 10,
-        full_text_weight: 1.0,
-        semantic_weight: 1.0,
-        rrf_k: 60,
-        filter_project: searchAll ? null : (project || null),
-        filter_source_type: null,
-        recency_weight: 0.15,
-        decay_days: 30.0
-      })
+      body: JSON.stringify(rpcBody)
     });
     if (!searchRes.ok) {
       const err = await searchRes.text();
+      console.error(`[flashback] direct RPC failed ${searchRes.status}:`, err);
       console.error('[mnestra-bridge:direct] supabase search failed:', err);
-      throw new Error('Memory search failed');
+      throw new Error(`Memory search failed (${searchRes.status})`);
     }
     const rows = await searchRes.json();
+    console.log(`[flashback] direct RPC returned ${rows.length} rows`);
     return {
       memories: rows.map((m) => ({
         content: m.content,
         source_type: m.source_type,
         project: m.project,
-        similarity: m.similarity,
+        // memory_hybrid_search returns `score`, not `similarity`.
+        similarity: m.similarity ?? m.score ?? null,
         created_at: m.created_at
       })),
       total: rows.length

package/packages/server/src/session.js

@@ -322,7 +322,10 @@ class Session {
 
     // Server-side rate limit: at most one error_detected event every 30s per session
     const now = Date.now();
-    if (now - this._lastErrorFireAt < 30000) return;
+    if (now - this._lastErrorFireAt < 30000) {
+      console.log(`[flashback] error detected in session ${this.id} but rate-limited (${Math.round((30000 - (now - this._lastErrorFireAt)) / 1000)}s left)`);
+      return;
+    }
     this._lastErrorFireAt = now;
 
     if (this.onErrorDetected) {
@@ -333,8 +336,11 @@ class Session {
       try {
         this.onErrorDetected(this, { lastCommand, tail });
       } catch (err) {
+        console.error('[flashback] onErrorDetected handler threw:', err);
         console.error('[session] onErrorDetected handler error:', err);
       }
+    } else {
+      console.log(`[flashback] error detected in session ${this.id} but no onErrorDetected handler wired`);
     }
   }