superlocalmemory 4.0.6 → 4.0.8

package/src/superlocalmemory/ui/js/od-operations.js

@@ -95,7 +95,6 @@
         '<button class="tab" data-od-tab="access">Access &amp; Users</button>' +
         '<button class="tab" data-od-tab="trust">Trust</button>' +
         '<button class="tab" data-od-tab="compliance">Compliance</button>' +
-        '<button class="tab" data-od-tab="loops">Bounded Loops</button>' +
         // Ingestion tab — restored: re-mounts #ingestion-overview + #ingestion-adapters
         // so ng-ingestion.js (loaded in index.html) can populate them on call.
         '<button class="tab" data-od-tab="ingestion">Ingestion</button>' +
@@ -203,155 +202,6 @@
         '</div>' +
       '</section>' +
 
-      // ══════ BOUNDED LOOPS TAB ════════════════════════════════════════
-      // Static info card — no backend calls.
-      // A bounded loop advances only when an INDEPENDENT gate passes, not
-      // when the agent claims success. Laps are persisted as SLM memory
-      // (tag loop:<name>) so the full run history is queryable.
-      '<section class="tabpane" data-od-pane="loops">' +
-
-        '<div class="page-head" style="margin-bottom:16px">' +
-          '<h2 style="font-size:20px;margin-bottom:6px">Bounded Loops</h2>' +
-          '<p style="font-size:13.5px">An iteration control pattern for agentic ' +
-            'frameworks &mdash; the loop advances only when an <strong>independent ' +
-            'gate</strong> passes, not when the agent claims success. Prevents ' +
-            'rationalisation: the model cannot self-certify completion.</p>' +
-        '</div>' +
-
-        // Two-column: concept + CLI reference
-        '<div class="grid" style="grid-template-columns:1fr 1fr;align-items:start;margin-bottom:16px">' +
-
-          '<div class="card">' +
-            '<div class="card-head"><h3>How it works</h3></div>' +
-            '<div class="card-pad">' +
-              '<p style="font-size:13px;line-height:1.6;margin-bottom:12px">' +
-                'Standard agentic loops let the model declare itself done &mdash; ' +
-                'a known failure mode when the model rationalises instead of verifying. ' +
-                'A bounded loop separates <em>execution</em> (the agent) from ' +
-                '<em>verification</em> (an independent gate such as a test suite, ' +
-                'linter, or judge LLM).' +
-              '</p>' +
-              '<p style="font-size:13px;line-height:1.6;margin-bottom:12px">' +
-                'The loop terminates only when the gate returns <code>DONE</code>, ' +
-                'or when a hard lap cap is reached (<code>HALT</code>). Each lap is ' +
-                'persisted as a queryable SLM memory tagged ' +
-                '<code>loop:&lt;name&gt;</code>.' +
-              '</p>' +
-              '<div style="background:var(--card-2);border-radius:var(--r-md);' +
-                'padding:10px 14px;font-size:12.5px;line-height:1.7">' +
-                '<div><span class="badge ok" style="margin-right:8px">DONE</span>' +
-                  'Gate passed &mdash; loop succeeded cleanly</div>' +
-                '<div style="margin-top:6px"><span class="badge warn" style="margin-right:8px">HALT</span>' +
-                  'Lap cap reached &mdash; hard stop applied</div>' +
-                '<div style="margin-top:6px"><span class="badge cyan" style="margin-right:8px">PAUSE</span>' +
-                  'Awaiting external input or approval</div>' +
-                '<div style="margin-top:6px"><span class="badge danger" style="margin-right:8px">KILLED</span>' +
-                  'Manually stopped by the operator</div>' +
-                '<div style="margin-top:6px"><span class="badge neutral" style="margin-right:8px">ERROR</span>' +
-                  'Unrecoverable failure during a lap</div>' +
-              '</div>' +
-            '</div>' +
-          '</div>' +
-
-          '<div class="card">' +
-            '<div class="card-head"><h3>Run it: CLI &middot; command &middot; MCP</h3></div>' +
-            '<div class="card-pad">' +
-              '<p style="font-size:13px;margin-bottom:14px">' +
-                'Bounded loops ship on three surfaces &mdash; the same engine and ' +
-                'the same queryable ledger behind each.' +
-              '</p>' +
-
-              '<div style="font-size:12px;font-weight:600;color:var(--fg-2);margin-bottom:6px">CLI</div>' +
-              '<div style="display:flex;flex-direction:column;gap:8px;margin-bottom:14px">' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm loop demo</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">Run a live demo bounded loop</span>' +
-                '</div>' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm loop history</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">List loop runs for this profile</span>' +
-                '</div>' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm loop show &lt;run_id&gt;</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">Inspect a run lap-by-lap</span>' +
-                '</div>' +
-              '</div>' +
-
-              '<div style="font-size:12px;font-weight:600;color:var(--fg-2);margin-bottom:6px">Command (Claude Code / Codex)</div>' +
-              '<div style="display:flex;flex-direction:column;gap:8px;margin-bottom:14px">' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">/slm-loop</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">Slash command bound to the slm-loop skill + runner agent</span>' +
-                '</div>' +
-              '</div>' +
-
-              '<div style="font-size:12px;font-weight:600;color:var(--fg-2);margin-bottom:6px">MCP tools (code / full / power profiles)</div>' +
-              '<div style="display:flex;flex-direction:column;gap:8px">' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm_loop_run</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">Run a gated loop &mdash; the gate is an independent SLM recall</span>' +
-                '</div>' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm_loop_history</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">List runs (read-only)</span>' +
-                '</div>' +
-                '<div class="list-row">' +
-                  '<span class="mono" style="min-width:190px;font-size:13px">slm_loop_show</span>' +
-                  '<span style="font-size:12.5px;color:var(--fg-2)">Show a run lap-by-lap (read-only)</span>' +
-                '</div>' +
-              '</div>' +
-              '<div style="margin-top:18px;padding:10px 14px;background:var(--card-2);' +
-                'border-radius:var(--r-md);font-size:12.5px;line-height:1.6">' +
-                '<b>Memory tagging:</b> each lap is stored with tag ' +
-                '<code>loop:&lt;name&gt;</code>. Recall the full history with ' +
-                '<br><code>slm recall --tag loop:my-loop-name</code>' +
-              '</div>' +
-            '</div>' +
-          '</div>' +
-
-        '</div>' + // end two-column grid
-
-        // Framework adapters note
-        '<div class="card">' +
-          '<div class="card-head"><h3>Framework adapters</h3></div>' +
-          '<div class="card-pad">' +
-            '<p style="font-size:13px;line-height:1.6;margin-bottom:14px">' +
-              'Bounded loops integrate with any agentic framework that supports ' +
-              'tool-call round-trips. The gate is an ordinary SLM memory check &mdash; ' +
-              'no special framework wiring required. Each framework stamps ' +
-              '<code>SLM_AGENT_ID</code> so lap history is attribution-aware.' +
-            '</p>' +
-            '<div style="display:flex;flex-wrap:wrap;gap:8px">' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">CrewAI</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">LangChain</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">LangGraph</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">Semantic Kernel</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">LlamaIndex</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">Microsoft Agent Framework</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">AutoGen</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">Google ADK</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">OpenAI Agents</span>' +
-              '<span style="padding:4px 12px;border-radius:99px;font-size:12px;' +
-                'background:var(--card-2);color:var(--fg-2)">Any MCP-compatible agent</span>' +
-            '</div>' +
-            '<p style="margin-top:12px;font-size:12.5px;color:var(--fg-2)">' +
-              'Learn the full pattern: run <code>/slm-loop</code> (the slm-loop skill) ' +
-              'inside Claude Code for an interactive walkthrough with live examples.' +
-            '</p>' +
-          '</div>' +
-        '</div>' +
-
-      '</section>' +
-
       // ══════ COMPLIANCE TAB ════════════════════════════════════════════
       '<section class="tabpane" data-od-pane="compliance">' +
 
@@ -494,6 +344,7 @@
     });
   }
 
+
   // ─── Lifecycle ────────────────────────────────────────────────────────────
   /**
    * Populate the lifecycle KPI strip.

package/src/superlocalmemory/ui/js/od-optimize.js

@@ -195,6 +195,18 @@
           '</button>' +
         '</div>' +
 
+        // Shown only while every counter is zero — see renderSavings(). Without
+        // it, "enabled" toggles above four zeros reads as a broken feature
+        // rather than an unused one.
+        '<div id="od-opt-unused-note" style="display:none;margin-bottom:14px;' +
+          'padding:12px 14px;border:1px dashed var(--border);border-radius:var(--r-md);' +
+          'font-size:13px;color:var(--fg-2);line-height:1.6">' +
+          '<strong style="color:var(--fg)">Enabled, but nothing has used it yet.</strong> ' +
+          'Caching and compression are opt-in: your AI assistant has to ask for ' +
+          'them. Turning them on here does not make savings happen by itself — ' +
+          'the numbers below stay at zero until an assistant calls them.' +
+        '</div>' +
+
         // KPI strip — 4 cards using .kpi-strip + .card.kpi classes
         '<section class="kpi-strip" style="margin-bottom:16px">' +
 
@@ -204,7 +216,11 @@
               '<span data-ic="bolt"></span> Tokens saved' +
             '</div>' +
             '<div class="value num" id="od-opt-tokens-saved">—</div>' +
-            '<div class="delta up" id="od-opt-tokens-delta">▲ this month</div>' +
+            // Was a hardcoded "▲ this month" delta — an upward trend indicator
+            // that no code ever set from data, on a counter that is cumulative
+            // since install and not monthly at all. Both halves of that label
+            // were wrong. State what the number actually is.
+            '<div class="delta" id="od-opt-tokens-delta">since install</div>' +
           '</div>' +
 
           // Cache hit rate + sparkline
@@ -420,15 +436,26 @@
     setText('od-opt-usd-saved',   fmtUSD(data.cost_saved && data.cost_saved.usd));
     setText('od-opt-inr-saved',   fmtINR(data.cost_saved && data.cost_saved.inr));
 
-    // Hit-rate sparkline
+    // The hit-rate sparkline used to be drawn from
+    //   [rate*0.7, rate*0.78, rate*0.83, rate*0.88, rate*0.93, rate]
+    // — six points invented by scaling the CURRENT value, rendering a tidy
+    // upward trend that no measurement supports. There is no history to plot:
+    // llmcache_metrics is a single cumulative row (id=1) and nothing anywhere
+    // stores a time series. A chart that fabricates its own past is worse than
+    // no chart, especially in a product that asks users to trust its numbers.
+    //
+    // Removed rather than replaced. When a real series exists, plot that.
     var sparkEl = document.getElementById('od-opt-hit-rate-spark');
-    if (sparkEl && typeof window.slmSpark === 'function') {
-      var rate = (data.hit_rate || 0) * 100;
-      var pts  = [
-        Math.round(rate * 0.7), Math.round(rate * 0.78), Math.round(rate * 0.83),
-        Math.round(rate * 0.88), Math.round(rate * 0.93), Math.round(rate)
-      ];
-      sparkEl.innerHTML = window.slmSpark(pts, { color: 'var(--cyan)', w: 96, h: 34 });
+    if (sparkEl) sparkEl.innerHTML = '';
+
+    // Everything reads zero while the toggles read ON, which looks broken. It
+    // is not: caching and compression are opt-in tools an agent has to call.
+    // Say so, rather than leaving the user to guess.
+    var noteEl = document.getElementById('od-opt-unused-note');
+    if (noteEl) {
+      var used = (data.hit_rate || 0) > 0 || tok > 0 ||
+                 (data.compress_ratio || 0) > 0;
+      noteEl.style.display = used ? 'none' : '';
     }
 
     // Provider table footnote removed in v2.1 (od-opt-prov-total element no longer exists).

package/src/superlocalmemory/ui/js/od-shell.js

@@ -81,6 +81,13 @@
     { g: 'Integrations', items: [
       { k: 'mcp-pane',       t: 'MCP & Tools', i: 'plug',     crumb: 'Integrations' },
       { k: 'mesh-pane',      t: 'Mesh Peers',  i: 'mesh',     crumb: 'Integrations' },
+      // 4.0.8: was a tab inside Governance. Every other Governance tab governs
+      // SLM's OWN data — lifecycle, access, trust, compliance, ingestion.
+      // Bounded Loops governs none of it: it is a separate product SLM
+      // optionally observes over a published contract, which is exactly what
+      // Integrations already means. "Not installed" is also an unremarkable
+      // answer here, where in a plane of its own an empty pane reads as broken.
+      { k: 'loops-pane',     t: 'Bounded Loops', i: 'shield', crumb: 'Integrations' },
     ]},
     { g: 'Config', items: [
       { k: 'settings-pane',  t: 'Settings',      i: 'settings', crumb: 'Config' },
@@ -517,6 +524,9 @@
         if (od('odRenderMesh')) return true;
         if (typeof loadMeshPeers === 'function') loadMeshPeers();
         return true;
+      case 'loops-pane':
+        od('odRenderLoops');
+        return true;
       case 'settings-pane':
         if (od('odRenderSettings')) return true;
         if (typeof loadSettings === 'function') loadSettings();