superlocalmemory 3.8.1 → 3.8.2

package/src/superlocalmemory/storage/embedding_migrator.py

@@ -26,6 +26,23 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
+# ---------------------------------------------------------------------------
+# Backfill constants
+# ---------------------------------------------------------------------------
+
+#: Default batch size for backfill_missing_embeddings.
+_BACKFILL_BATCH_SIZE = 50
+
+#: Max characters embedded per fact during backfill. The embedding model
+#: (nomic-embed-text-v1.5) truncates at ~8192 tokens anyway, but a raw
+#: oversized document (observed up to 107 KB on a real DB) makes the shared
+#: single-worker embedder busy for 15-20s on ONE fact — starving foreground
+#: recall during a self-heal pass. Bounding the input keeps every fact's embed
+#: fast and the worker responsive; the leading slice captures the fact's gist
+#: for semantic recall. Facts this large are documents that were almost
+#: certainly NULL because they failed to embed at ingestion for the same reason.
+_MAX_EMBED_CHARS = 8000
+
 # Sentinel stored in config.json when no model has been set yet.
 _NO_MODEL = ""
 
@@ -44,6 +61,24 @@ def _model_signature(config: SLMConfig) -> str:
     return f"{emb.model_name}::{emb.dimension}"
 
 
+def _normalize_signature(signature: str) -> str:
+    """Normalize a signature for equivalence comparison.
+
+    v3.8.2 self-healing: the SAME embedding model has been recorded under
+    different name strings across releases — notably the HuggingFace org
+    prefix drifted (``nomic-ai/nomic-embed-text-v1.5`` vs the bare
+    ``nomic-embed-text-v1.5``). A prefix-only difference does NOT change the
+    embedding vector space, so it must not trigger a full multi-hour re-embed
+    when a non-technical user upgrades. This collapses the model name to its
+    basename (segment after the last ``/``) while keeping the ``::dimension``
+    suffix — a genuine model change (different basename OR dimension) still
+    differs and still triggers migration.
+    """
+    model, sep, dim = signature.partition("::")
+    model = model.rsplit("/", 1)[-1].strip()
+    return f"{model}{sep}{dim}" if sep else model
+
+
 def _read_stored_signature(config_dir: Path) -> str:
     """Read the last-used embedding model signature from config.json."""
     config_path = config_dir / "config.json"
@@ -88,6 +123,19 @@ def check_embedding_migration(config: SLMConfig) -> bool:
     if stored_sig == current_sig:
         return False
 
+    # v3.8.2 self-healing: a prefix-only model-name drift (e.g. the nomic-ai/
+    # org prefix appearing/disappearing between releases) is the SAME vector
+    # space — absorb the transition by refreshing the stored signature to the
+    # current form, with NO re-embed. This spares non-technical users a
+    # multi-hour full re-index on a cosmetic upgrade.
+    if _normalize_signature(stored_sig) == _normalize_signature(current_sig):
+        _write_stored_signature(config.base_dir, current_sig)
+        logger.info(
+            "Embedding signature normalized (no re-embed): %s ~= %s",
+            stored_sig, current_sig,
+        )
+        return False
+
     logger.warning(
         "Embedding model changed: %s -> %s. Re-indexing required.",
         stored_sig, current_sig,
@@ -177,3 +225,190 @@ def run_embedding_migration(
         reindexed, total,
     )
     return reindexed
+
+
+# ---------------------------------------------------------------------------
+# Backfill: embed facts that were NEVER embedded (embedding IS NULL)
+# ---------------------------------------------------------------------------
+
+def _count_null_embeddings(
+    db: Any,
+    profile_id: str,
+    all_profiles: bool,
+) -> int:
+    """Return count of atomic_facts rows with NULL embedding."""
+    if all_profiles:
+        rows = db.execute(
+            "SELECT count(*) AS c FROM atomic_facts WHERE embedding IS NULL",
+        )
+    else:
+        rows = db.execute(
+            "SELECT count(*) AS c FROM atomic_facts "
+            "WHERE embedding IS NULL AND profile_id = ?",
+            (profile_id,),
+        )
+    return int(rows[0]["c"]) if rows else 0
+
+
+def backfill_missing_embeddings(
+    config: "SLMConfig",
+    db: Any,
+    embedder: Any,
+    batch_size: int = _BACKFILL_BATCH_SIZE,
+    limit: int | None = None,
+    all_profiles: bool = False,
+) -> dict[str, int]:
+    """Embed atomic_facts rows whose ``embedding`` column is NULL.
+
+    Unlike :func:`run_embedding_migration` (which re-embeds on model-signature
+    change), this function handles facts that were *never* embedded — for
+    example facts stored while the embedder was unavailable.
+
+    Resumable and idempotent: re-running after a partial run only processes
+    the remaining NULLs.  Fail-open per-fact: a single bad fact logs a warning
+    and is skipped; the batch continues.
+
+    Writes mirror :func:`run_embedding_migration` exactly:
+    * ``atomic_facts.embedding`` ← ``json.dumps(vector)``
+    * ``embedding_metadata`` ← upserted row with current model name + dimension
+
+    Args:
+        config: Active SLMConfig (provides profile_id, model name, dimension).
+        db: DatabaseManager (or duck-compatible object with ``.execute()``).
+        embedder: Object implementing ``embed_batch(texts) -> list[vec|None]``
+            and (optionally) ``embed(text) -> vec|None``.  Pass ``None`` to
+            make this a no-op (returns zero counts).
+        batch_size: Facts per embed_batch() call.  Defaults to 50.
+        limit: Maximum facts to embed in this call.  ``None`` means no cap —
+            all NULL-embedding facts are processed.  Use a bounded limit for
+            the maintenance self-healing path so each pass is quick.
+        all_profiles: When ``True``, processes facts from every profile in the
+            database.  When ``False`` (default), scopes to
+            ``config.active_profile``.
+
+    Returns:
+        ``{"scanned": int, "embedded": int, "remaining_null": int}``
+
+        *scanned*: total NULL-embedding facts found before applying *limit*.
+        *embedded*: facts successfully written in this call.
+        *remaining_null*: NULL count after the call (includes facts not yet
+            reached because of *limit*).
+    """
+    profile_id = config.active_profile
+
+    if embedder is None:
+        logger.warning(
+            "backfill_missing_embeddings: no embedder available — skipping."
+        )
+        return {"scanned": 0, "embedded": 0, "remaining_null": 0}
+
+    # ------------------------------------------------------------------
+    # 1. Fetch all NULL-embedding facts (cheap query; only reads IDs + content)
+    # ------------------------------------------------------------------
+    if all_profiles:
+        rows = db.execute(
+            "SELECT fact_id, content, profile_id FROM atomic_facts "
+            "WHERE embedding IS NULL ORDER BY created_at",
+        )
+    else:
+        rows = db.execute(
+            "SELECT fact_id, content, profile_id FROM atomic_facts "
+            "WHERE embedding IS NULL AND profile_id = ? ORDER BY created_at",
+            (profile_id,),
+        )
+
+    facts: list[tuple[str, str, str]] = [
+        (dict(r)["fact_id"], dict(r)["content"], dict(r)["profile_id"])
+        for r in rows
+    ]
+    scanned = len(facts)
+
+    if scanned == 0:
+        return {"scanned": 0, "embedded": 0, "remaining_null": 0}
+
+    # Apply call-level limit (resumability: next call picks up where this left off)
+    if limit is not None:
+        facts = facts[:limit]
+
+    current_model = config.embedding.model_name
+    current_dim = config.embedding.dimension
+    embedded = 0
+
+    # ------------------------------------------------------------------
+    # 2. Batch embed and write back
+    # ------------------------------------------------------------------
+    for batch_start in range(0, len(facts), batch_size):
+        batch = facts[batch_start : batch_start + batch_size]
+        # Bound per-fact input so an oversized document doesn't monopolize the
+        # shared embedding worker (starving foreground recall during self-heal).
+        texts = [(content or "")[:_MAX_EMBED_CHARS] for _, content, _ in batch]
+        fact_ids = [fid for fid, _, _ in batch]
+        prof_ids = [pid for _, _, pid in batch]
+
+        # Attempt batch embed; fall back to per-fact on batch failure.
+        try:
+            vectors: list[Any] = embedder.embed_batch(texts)
+        except Exception as exc:
+            logger.warning(
+                "backfill: batch embed failed for facts %d-%d: %s — "
+                "retrying per-fact.",
+                batch_start,
+                batch_start + len(batch),
+                exc,
+            )
+            vectors = []
+            for text in texts:
+                try:
+                    vec = embedder.embed(text)
+                    vectors.append(vec)
+                except Exception as per_fact_exc:
+                    logger.warning(
+                        "backfill: per-fact embed failed for '%s...': %s",
+                        text[:40],
+                        per_fact_exc,
+                    )
+                    vectors.append(None)
+
+        # Write each successfully-embedded fact back to the DB.
+        for fid, vec, pid in zip(fact_ids, vectors, prof_ids):
+            if vec is None:
+                logger.warning(
+                    "backfill: null vector for fact %s — skipping.", fid[:16]
+                )
+                continue
+            try:
+                embedding_json = json.dumps(vec)
+                # Mirror run_embedding_migration's write path exactly.
+                db.execute(
+                    "UPDATE atomic_facts SET embedding = ? WHERE fact_id = ?",
+                    (embedding_json, fid),
+                )
+                # Upsert embedding_metadata.  NULL-embedding facts have no row
+                # here yet, so we INSERT; if a row somehow exists, update it.
+                db.execute(
+                    "INSERT INTO embedding_metadata"
+                    "    (fact_id, profile_id, model_name, dimension)"
+                    " VALUES (?, ?, ?, ?)"
+                    " ON CONFLICT(fact_id) DO UPDATE SET"
+                    "    model_name = excluded.model_name",
+                    (fid, pid, current_model, current_dim),
+                )
+                embedded += 1
+            except Exception as exc:
+                logger.warning(
+                    "backfill: failed to write fact %s: %s", fid[:16], exc
+                )
+
+    # ------------------------------------------------------------------
+    # 3. Count remaining NULLs (accounts for the limit; tells caller how
+    #    many passes remain before full convergence).
+    # ------------------------------------------------------------------
+    remaining = _count_null_embeddings(db, profile_id, all_profiles)
+
+    logger.info(
+        "Embedding backfill: %d/%d facts embedded, %d remaining NULL.",
+        embedded,
+        scanned,
+        remaining,
+    )
+    return {"scanned": scanned, "embedded": embedded, "remaining_null": remaining}

package/src/superlocalmemory/ui/index.html

@@ -1566,7 +1566,8 @@
     <!-- OD screen modules (v3.7.9): approved-design panes wired to live data.
          Load LAST so their window.load<Screen> overrides win over the legacy loaders. -->
     <script src="static/js/od-brain.js?v=379"></script>
-    <script src="static/js/od-health.js?v=380"></script>
+    <script src="static/js/od-components.js?v=382"></script>
+    <script src="static/js/od-health.js?v=382"></script>
     <script src="static/js/od-operations.js?v=380"></script>
     <script src="static/js/od-team.js?v=379"></script>
     <script src="static/js/od-graph.js?v=379"></script>
@@ -1577,7 +1578,7 @@
     <script src="static/js/od-skills.js?v=379"></script>
     <script src="static/js/od-mesh.js?v=379"></script>
     <script src="static/js/od-optimize.js?v=379"></script>
-    <script src="static/js/od-settings.js?v=380"></script>
+    <script src="static/js/od-settings.js?v=382"></script>
     <script src="static/js/od-backup.js?v=379"></script>
     <!-- MCP & Integrations pane (v3.8.0): shows exposed MCP tool profile + counts -->
     <script src="static/js/od-mcp.js?v=380"></script>

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

@@ -0,0 +1,147 @@
+// od-components.js — System Health "What's Missing" report (v3.8.2 UX-6)
+//
+// window.odRenderComponents(el) renders the component-registry snapshot from
+//   GET  /api/v3/components          → {components:[...], summary:{...}}
+// into `el`, showing per-component status, a copy-paste fix command for the
+// items SLM can't repair on its own, and a "Retry now" button that triggers
+//   POST /api/v3/components/heal     (install token auto-attached by core.js)
+// The daemon auto-heals on start; this panel is transparency + a manual
+// fallback for the non-technical user.
+//
+// Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar — AGPL-3.0
+
+/* global window, document, fetch, navigator, setTimeout */
+(function () {
+  'use strict';
+
+  function esc(s) {
+    return String(s == null ? '' : s)
+      .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+  }
+
+  // Severity/glyph/colour for one component, honouring its category so an
+  // absent optional backend is not shown as an error.
+  function view(c) {
+    var st = String(c.status || '').toLowerCase();
+    if (st === 'ok') return { g: '✓', col: 'var(--ok)', tip: 'ready' };
+    if (st === 'retrying') return { g: '⟳', col: 'var(--accent, #4a9)', tip: 'repairing' };
+    if (st === 'degraded') return { g: '⚠', col: 'var(--warn)', tip: 'degraded' };
+    // missing — severity depends on how much SLM needs it.
+    if (c.category === 'required') return { g: '✗', col: 'var(--danger)', tip: 'missing' };
+    if (c.category === 'recommended') return { g: '⚠', col: 'var(--warn)', tip: 'missing' };
+    return { g: '○', col: 'var(--fg-2)', tip: 'optional' };
+  }
+
+  function rowHtml(c) {
+    var v = view(c);
+    var fix = '';
+    if (c.status !== 'ok' && c.fix_cmd) {
+      if (c.auto_fixable) {
+        fix = '<div class="muted" style="margin-top:2px;font-size:12px">'
+            + 'SLM repairs this automatically.</div>';
+      } else {
+        fix = '<div style="margin-top:4px;display:flex;gap:6px;align-items:center">'
+            + '<code style="font-size:12px;background:var(--bg-2,#0002);'
+            + 'padding:2px 6px;border-radius:4px">' + esc(c.fix_cmd) + '</code>'
+            + '<button class="od-copy-fix" data-cmd="' + esc(c.fix_cmd) + '" '
+            + 'style="font-size:11px;padding:1px 6px;cursor:pointer">Copy</button>'
+            + '</div>';
+      }
+    }
+    return '<div style="padding:8px 0;border-bottom:1px solid var(--border,#8881)">'
+      + '<div style="display:flex;gap:8px;align-items:baseline">'
+      + '<span style="color:' + v.col + ';font-weight:700;width:16px;text-align:center">'
+      + v.g + '</span>'
+      + '<div style="flex:1">'
+      + '<span style="font-weight:600">' + esc(c.label) + '</span>'
+      + ' <span class="muted" style="font-size:12px">' + esc(c.detail || v.tip) + '</span>'
+      + fix
+      + '</div></div></div>';
+  }
+
+  function render(el, data) {
+    var comps = (data && data.components) || [];
+    var s = (data && data.summary) || {};
+    var healthy = !!s.healthy;
+    var hasAutoFix = (s.auto_fixable_missing || 0) > 0;
+
+    var head = '<div style="display:flex;justify-content:space-between;'
+      + 'align-items:center;margin-bottom:6px">'
+      + '<h3 style="margin:0">System Health — Components</h3>'
+      + '<span style="padding:2px 10px;border-radius:12px;font-size:12px;'
+      + 'background:' + (healthy ? 'var(--ok)' : 'var(--warn)') + ';color:#000">'
+      + (healthy ? 'All good' : 'Needs attention') + '</span></div>';
+
+    var summary = '<div class="muted" style="font-size:12px;margin-bottom:8px">'
+      + (s.ok || 0) + ' ready · ' + (s.missing || 0) + ' missing · '
+      + (s.degraded || 0) + ' degraded'
+      + (s.retrying ? ' · ' + s.retrying + ' repairing' : '') + '</div>';
+
+    var actions = '<div style="margin-top:10px;display:flex;gap:8px">'
+      + '<button id="od-comp-recheck" style="padding:4px 12px;cursor:pointer">Recheck</button>'
+      + (hasAutoFix
+          ? '<button id="od-comp-retry" style="padding:4px 12px;cursor:pointer;'
+            + 'background:var(--accent,#4a9);color:#000;border:none;border-radius:4px">'
+            + 'Retry now</button>'
+          : '')
+      + '</div>'
+      + '<div class="muted" style="font-size:11px;margin-top:6px">'
+      + 'SLM auto-repairs fixable items on start. Copy a command for anything '
+      + 'it can’t install for you.</div>';
+
+    el.innerHTML = head + summary
+      + '<div>' + comps.map(rowHtml).join('') + '</div>' + actions;
+
+    // Copy buttons.
+    el.querySelectorAll('.od-copy-fix').forEach(function (b) {
+      b.addEventListener('click', function () {
+        var cmd = b.getAttribute('data-cmd') || '';
+        if (navigator.clipboard) navigator.clipboard.writeText(cmd);
+        var old = b.textContent; b.textContent = 'Copied';
+        setTimeout(function () { b.textContent = old; }, 1200);
+      });
+    });
+    var recheck = el.querySelector('#od-comp-recheck');
+    if (recheck) recheck.addEventListener('click', function () { load(el); });
+    var retry = el.querySelector('#od-comp-retry');
+    if (retry) retry.addEventListener('click', function () { doRetry(el, retry); });
+  }
+
+  function load(el) {
+    if (!el) return;
+    el.innerHTML = '<p class="muted" style="padding:8px 0">Checking components…</p>';
+    fetch('/api/v3/components')
+      .then(function (r) { return r.ok ? r.json() : null; })
+      .then(function (data) {
+        if (!data) {
+          el.innerHTML = '<p class="muted" style="padding:8px 0">'
+            + 'Component health unavailable (is the daemon running?).</p>';
+          return;
+        }
+        render(el, data);
+      })
+      .catch(function () {
+        el.innerHTML = '<p class="muted" style="padding:8px 0">'
+          + 'Could not load component health.</p>';
+      });
+  }
+
+  // Trigger a background heal, then poll a few times so the panel reflects
+  // the retrying → ok transition without the user refreshing.
+  function doRetry(el, btn) {
+    btn.disabled = true; btn.textContent = 'Repairing…';
+    fetch('/api/v3/components/heal', { method: 'POST', credentials: 'same-origin' })
+      .then(function () {
+        var tries = 0;
+        (function poll() {
+          tries += 1;
+          load(el);
+          if (tries < 4) setTimeout(poll, 2500);
+        })();
+      })
+      .catch(function () { load(el); });
+  }
+
+  window.odRenderComponents = load;
+})();

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

@@ -396,6 +396,17 @@
             _dateField('Last seen',  listEnt.last_seen)  +
             _dateField('Compiled',   d.last_compiled_at) +
           '</div>' +
+          // Recompile action — restored: POST /api/entity/{name}/recompile
+          // The disabled guard was removed; data-ename carries the name to _wire() handler.
+          '<div style="margin-top:16px;display:flex;align-items:center;gap:10px">' +
+            '<button data-od-act="recompile-entity" ' +
+              'data-ename="' + _esc(d.entity_name || '') + '" ' +
+              'style="padding:5px 14px;border:1px solid var(--border);border-radius:5px;' +
+                'font-size:12px;cursor:pointer;background:var(--bg-2);color:var(--fg)">' +
+              'Recompile</button>' +
+            '<span id="' + id + '-recompile-status" ' +
+              'style="font-size:12px;color:var(--fg-2)"></span>' +
+          '</div>' +
         '</div>' +
       '</div>' +
 
@@ -514,12 +525,44 @@
 
   // ── Event delegation ──────────────────────────────────────────────────────
 
+  // Recompile entity — POST /api/entity/{name}/recompile
+  // Updates button text and status span to give feedback without a page reload.
+  function _recompileEntity(id, name, btn) {
+    if (!name) return;
+    var statusEl = document.getElementById(id + '-recompile-status');
+    btn.disabled = true;
+    btn.textContent = 'Recompiling…';
+    if (statusEl) { statusEl.textContent = ''; }
+    fetch('/api/entity/' + encodeURIComponent(name) + '/recompile', { method: 'POST' })
+      .then(function (r) { return r.json(); })
+      .then(function (data) {
+        btn.disabled = false;
+        btn.textContent = 'Recompile';
+        if (statusEl) {
+          statusEl.style.color = 'var(--accent)';
+          statusEl.textContent = data.message || 'Recompiled successfully';
+        }
+      })
+      .catch(function (err) {
+        btn.disabled = false;
+        btn.textContent = 'Recompile';
+        if (statusEl) {
+          statusEl.style.color = 'var(--danger, #e05)';
+          statusEl.textContent = 'Recompile failed: ' + (err.message || 'unknown error');
+        }
+      });
+  }
+
   function _wire(container, id) {
     container.addEventListener('click', function (e) {
       var el = e.target.closest('[data-od-act]');
       if (!el) return;
       var act = el.dataset.odAct;
 
+      if (act === 'recompile-entity') {
+        _recompileEntity(id, el.dataset.ename, el);
+        return;
+      }
       if (act === 'type-filter') {
         _st = Object.assign({}, _st, { typeFilter: el.dataset.type, page: 0 });
         _refreshTypeChips(id, el.dataset.type);

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

@@ -93,6 +93,31 @@
           '<div class="inspector-empty"><div style="font-size:34px;margin-bottom:8px">&#9671;</div>' +
           'Loading your knowledge graph…</div>' +
         '</div>' +
+        // Quick Insight Actions — restored: 5 data-insight-action buttons + #insight-results.
+        // quick-actions.js (global, non-IIFE) defines fetchInsight(action) which calls
+        // GET /api/v3/insights/{action} and writes into #insight-results.
+        // Delegation wired in wireControls() so buttons survive re-renders.
+        '<div id="odg-insights-panel" style="border-top:1px solid var(--border);' +
+          'padding:10px 12px 8px">' +
+          '<div style="font-size:10.5px;font-weight:600;color:var(--fg-3);' +
+            'text-transform:uppercase;letter-spacing:0.06em;margin-bottom:7px">' +
+            'Quick Insights</div>' +
+          '<div style="display:flex;flex-wrap:wrap;gap:5px;margin-bottom:7px">' +
+            '<button class="chip" style="font-size:11px;padding:3px 9px;cursor:pointer" ' +
+              'data-insight-action="changed_this_week">Changed This Week</button>' +
+            '<button class="chip" style="font-size:11px;padding:3px 9px;cursor:pointer" ' +
+              'data-insight-action="opinions">Opinions</button>' +
+            '<button class="chip" style="font-size:11px;padding:3px 9px;cursor:pointer" ' +
+              'data-insight-action="contradictions">Contradictions</button>' +
+            '<button class="chip" style="font-size:11px;padding:3px 9px;cursor:pointer" ' +
+              'data-insight-action="health">Memory Health</button>' +
+            '<button class="chip" style="font-size:11px;padding:3px 9px;cursor:pointer" ' +
+              'data-insight-action="cross_project">Cross-Project</button>' +
+          '</div>' +
+          // #insight-results — quick-actions.js writes here via document.getElementById
+          '<div id="insight-results" ' +
+            'style="max-height:200px;overflow-y:auto;font-size:12px"></div>' +
+        '</div>' +
         '<div class="ask">' +
           '<div class="ask-head"><span data-ic="brain"></span> Ask your memory</div>' +
           '<div class="ask-log" id="odg-log">' +
@@ -502,6 +527,16 @@
     q('#odg-send').onclick = sendAsk;
     q('#odg-ask').addEventListener('keydown', function (e) { if (e.key === 'Enter') sendAsk(); });
 
+    // Quick Insight Actions — delegated on mount so buttons survive od-graph.js re-renders.
+    // quick-actions.js:fetchInsight() is global (non-IIFE); it writes into #insight-results
+    // which is mounted inside odg-insights-panel above.
+    mount.addEventListener('click', function (e) {
+      var btn = e.target.closest('[data-insight-action]');
+      if (btn && typeof fetchInsight === 'function') {
+        fetchInsight(btn.getAttribute('data-insight-action'));
+      }
+    });
+
     cv.addEventListener('mousedown', function (e) {
       var r = cv.getBoundingClientRect(), n = nodeAt(e.clientX - r.left, e.clientY - r.top);
       if (n) { dragNode = n; selected = n; renderInsp(n); wake(); } else { panning = true; }

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

@@ -183,6 +183,20 @@
             '</tbody>' +
           '</table>' +
         '</div>' +
+      '</div>' +
+
+      // System Health — Components (v3.8.2 UX-6): what's installed vs missing,
+      // with copy-paste fix commands + a Retry-now button. The daemon
+      // auto-heals fixable items on start; this is transparency + fallback.
+      // Rendered by od-components.js → window.odRenderComponents.
+      '<div class="card" style="margin-top:16px">' +
+        '<div class="card-head">' +
+          '<h3>System Health — Components</h3>' +
+          '<span class="sub">models &amp; dependencies · self-healing</span>' +
+        '</div>' +
+        '<div class="card-pad" id="od-h-components">' +
+          '<div class="dim" style="text-align:center;padding:20px">Loading…</div>' +
+        '</div>' +
       '</div>'
     );
   }
@@ -515,6 +529,10 @@
       populateTrustSignals(trustStats);
       populateAgentSummary(agentsData, eventsStats);
       populateAgentTable(agentsData);
+      // v3.8.2 UX-6: component "what's missing" report (od-components.js).
+      if (typeof window.odRenderComponents === 'function') {
+        window.odRenderComponents(document.getElementById('od-h-components'));
+      }
 
     }).catch(function (err) {
       container.innerHTML =

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

@@ -147,6 +147,9 @@
           '<button class="tab" data-od-act="tab" data-tab="timeline">Creation timeline</button>' +
           '<button class="tab" data-od-act="tab" data-tab="clusters">' +
             'Knowledge clusters <span class="cnt" id="' + id + '-cnt-clusters">…</span></button>' +
+          // Recall Lab tab — restored: recall-lab.js is already loaded in index.html and uses
+          // document-level click/keydown delegation keyed on IDs below, so it survives re-renders.
+          '<button class="tab" data-od-act="tab" data-tab="recall">Recall Lab</button>' +
         '</div>' +
         '<div class="tabpane active" id="' + id + '-pane-all">' + _allScaffold(id) + '</div>' +
         '<div class="tabpane" id="' + id + '-pane-timeline">' + _tlScaffold(id) + '</div>' +
@@ -155,6 +158,40 @@
             _loading('Loading clusters…') +
           '</div>' +
         '</div>' +
+        // Recall Lab pane — exact IDs required by recall-lab.js:
+        //   #recall-lab-query (input), #recall-lab-search (button — click check),
+        //   #recall-lab-per-page (select, optional), #recall-lab-meta, #recall-lab-results.
+        // Backend: POST /api/v3/recall/trace
+        '<div class="tabpane" id="' + id + '-pane-recall" style="padding-top:12px">' +
+          '<div style="margin-bottom:14px">' +
+            '<p style="font-size:13px;color:var(--fg-2);margin-bottom:10px">' +
+              'Trace how a recall query is resolved — matching algorithm, scoring, and final result set.' +
+            '</p>' +
+            '<div style="display:flex;gap:8px;align-items:center;flex-wrap:wrap">' +
+              '<input id="recall-lab-query" placeholder="Enter recall query…" autocomplete="off" ' +
+                'style="flex:1;min-width:200px;padding:8px 12px;' +
+                  'border:1px solid var(--border);border-radius:6px;font-size:13px;' +
+                  'background:var(--bg-2);color:var(--fg)">' +
+              '<select id="recall-lab-per-page" ' +
+                'style="padding:7px 10px;border:1px solid var(--border);border-radius:6px;' +
+                  'font-size:13px;background:var(--bg-2);color:var(--fg)">' +
+                '<option value="5">5</option>' +
+                '<option value="10" selected>10</option>' +
+                '<option value="20">20</option>' +
+                '<option value="50">50</option>' +
+              '</select>' +
+              '<button id="recall-lab-search" ' +
+                'style="padding:8px 18px;background:var(--accent);color:#fff;' +
+                  'border:none;border-radius:6px;font-size:13px;cursor:pointer;' +
+                  'white-space:nowrap">Run Trace</button>' +
+            '</div>' +
+          '</div>' +
+          // #recall-lab-meta — written by recall-lab.js before results (timing, count, etc.)
+          '<div id="recall-lab-meta" ' +
+            'style="font-size:12px;color:var(--fg-2);margin-bottom:8px"></div>' +
+          // #recall-lab-results — written by recall-lab.js (result cards, pagination)
+          '<div id="recall-lab-results"></div>' +
+        '</div>' +
       '</div>'
     );
   }