superlocalmemory 3.4.0 → 3.4.3

package/src/superlocalmemory/storage/schema_v343.py

@@ -0,0 +1,229 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under the Elastic License 2.0 - see LICENSE file
+# Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
+
+"""SuperLocalMemory V3.4.3 "The Unified Brain" — Schema Extensions.
+
+All new tables for v3.4.3 features:
+  - Phase C: Mesh broker tables (mesh_peers, mesh_messages, mesh_state, mesh_locks, mesh_events)
+  - Phase D: Entity compilation (ALTER entity_profiles + new index)
+  - Phase E: Ingestion log (ingestion_log)
+
+Design rules (inherited from schema_v32.py):
+  - CREATE IF NOT EXISTS for idempotency
+  - profile_id where applicable
+  - Never ALTER existing column types (add new columns only)
+
+Part of Qualixar | Author: Varun Pratap Bhardwaj
+"""
+
+from __future__ import annotations
+
+import logging
+import sqlite3
+from typing import Final
+
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# Table names (for reference and rollback)
+# ---------------------------------------------------------------------------
+
+V343_TABLES: Final[tuple[str, ...]] = (
+    "mesh_peers",
+    "mesh_messages",
+    "mesh_state",
+    "mesh_locks",
+    "mesh_events",
+    "ingestion_log",
+)
+
+# ---------------------------------------------------------------------------
+# DDL — Phase C: Mesh Broker Tables
+# ---------------------------------------------------------------------------
+
+_MESH_DDL = """
+-- Mesh Peers
+CREATE TABLE IF NOT EXISTS mesh_peers (
+    peer_id TEXT PRIMARY KEY,
+    session_id TEXT NOT NULL,
+    summary TEXT DEFAULT '',
+    status TEXT DEFAULT 'active',
+    host TEXT DEFAULT '127.0.0.1',
+    port INTEGER DEFAULT 0,
+    registered_at TEXT NOT NULL,
+    last_heartbeat TEXT NOT NULL
+);
+
+-- Mesh Messages
+CREATE TABLE IF NOT EXISTS mesh_messages (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_peer TEXT NOT NULL,
+    to_peer TEXT NOT NULL,
+    msg_type TEXT DEFAULT 'text',
+    content TEXT NOT NULL,
+    read INTEGER DEFAULT 0,
+    created_at TEXT NOT NULL
+);
+
+-- Mesh State (shared key-value store)
+CREATE TABLE IF NOT EXISTS mesh_state (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL,
+    set_by TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+);
+
+-- Mesh Locks (file-level locks for coordination)
+CREATE TABLE IF NOT EXISTS mesh_locks (
+    file_path TEXT PRIMARY KEY,
+    locked_by TEXT NOT NULL,
+    locked_at TEXT NOT NULL,
+    expires_at TEXT NOT NULL DEFAULT '9999-12-31T23:59:59Z'
+);
+
+-- Mesh Events (audit log)
+CREATE TABLE IF NOT EXISTS mesh_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    event_type TEXT NOT NULL,
+    payload TEXT DEFAULT '{}',
+    emitted_by TEXT NOT NULL,
+    created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_mesh_messages_to
+    ON mesh_messages(to_peer, read);
+CREATE INDEX IF NOT EXISTS idx_mesh_events_type
+    ON mesh_events(event_type, created_at);
+"""
+
+# ---------------------------------------------------------------------------
+# DDL — Phase D: Entity Compilation (ALTER entity_profiles)
+# ---------------------------------------------------------------------------
+
+_ENTITY_COMPILATION_ALTERS = [
+    "ALTER TABLE entity_profiles ADD COLUMN project_name TEXT DEFAULT ''",
+    "ALTER TABLE entity_profiles ADD COLUMN compiled_truth TEXT DEFAULT ''",
+    "ALTER TABLE entity_profiles ADD COLUMN timeline TEXT DEFAULT '[]'",
+    "ALTER TABLE entity_profiles ADD COLUMN compilation_confidence REAL DEFAULT 0.5",
+    "ALTER TABLE entity_profiles ADD COLUMN last_compiled_at TEXT DEFAULT NULL",
+]
+
+_ENTITY_COMPILATION_INDEX = """
+CREATE UNIQUE INDEX IF NOT EXISTS idx_entity_profiles_compilation
+    ON entity_profiles(entity_id, profile_id, project_name);
+CREATE INDEX IF NOT EXISTS idx_entity_profiles_project
+    ON entity_profiles(profile_id, project_name);
+"""
+
+# ---------------------------------------------------------------------------
+# DDL — Phase E: Ingestion Log
+# ---------------------------------------------------------------------------
+
+_INGESTION_DDL = """
+CREATE TABLE IF NOT EXISTS ingestion_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_type TEXT NOT NULL,
+    dedup_key TEXT NOT NULL,
+    fact_ids TEXT DEFAULT '[]',
+    metadata TEXT DEFAULT '{}',
+    status TEXT DEFAULT 'ingested',
+    ingested_at TEXT NOT NULL,
+    UNIQUE(source_type, dedup_key)
+);
+CREATE INDEX IF NOT EXISTS idx_ingestion_dedup
+    ON ingestion_log(source_type, dedup_key);
+"""
+
+# ---------------------------------------------------------------------------
+# Version marker
+# ---------------------------------------------------------------------------
+
+_VERSION_DDL = """
+CREATE TABLE IF NOT EXISTS schema_version (
+    version TEXT PRIMARY KEY,
+    applied_at TEXT NOT NULL
+);
+"""
+
+
+# ---------------------------------------------------------------------------
+# Migration runner
+# ---------------------------------------------------------------------------
+
+def apply_v343_schema(db_path: str | sqlite3.Connection) -> dict:
+    """Apply all v3.4.3 schema changes. Idempotent — safe to call multiple times.
+
+    Returns dict with migration status and any errors.
+    """
+    result = {"applied": [], "skipped": [], "errors": []}
+
+    if isinstance(db_path, sqlite3.Connection):
+        conn = db_path
+        own_connection = False
+    else:
+        conn = sqlite3.connect(str(db_path))
+        own_connection = True
+
+    try:
+        # Check if already applied
+        try:
+            row = conn.execute(
+                "SELECT version FROM schema_version WHERE version = '3.4.3'"
+            ).fetchone()
+            if row:
+                result["skipped"].append("v3.4.3 already applied")
+                return result
+        except sqlite3.OperationalError:
+            pass  # schema_version table doesn't exist yet
+
+        # Apply version table
+        conn.executescript(_VERSION_DDL)
+
+        # Phase C: Mesh tables
+        try:
+            conn.executescript(_MESH_DDL)
+            result["applied"].append("mesh tables (5 tables, 2 indexes)")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"mesh: {e}")
+
+        # Phase D: Entity compilation ALTER TABLE
+        for alter_sql in _ENTITY_COMPILATION_ALTERS:
+            try:
+                conn.execute(alter_sql)
+                result["applied"].append(alter_sql.split("ADD COLUMN")[1].strip().split()[0])
+            except sqlite3.OperationalError:
+                # Column already exists — fine (idempotent)
+                pass
+
+        try:
+            conn.executescript(_ENTITY_COMPILATION_INDEX)
+            result["applied"].append("entity_profiles indexes")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"entity indexes: {e}")
+
+        # Phase E: Ingestion log
+        try:
+            conn.executescript(_INGESTION_DDL)
+            result["applied"].append("ingestion_log table")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"ingestion: {e}")
+
+        # Mark version
+        conn.execute(
+            "INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)",
+            ("3.4.3", __import__("datetime").datetime.now().isoformat()),
+        )
+        conn.commit()
+
+        if result["applied"]:
+            logger.info("Schema v3.4.3 applied: %s", ", ".join(result["applied"]))
+
+    except Exception as e:
+        result["errors"].append(f"fatal: {e}")
+        logger.error("Schema v3.4.3 migration failed: %s", e)
+    finally:
+        if own_connection:
+            conn.close()
+
+    return result

package/src/superlocalmemory/ui/index.html

@@ -654,6 +654,9 @@
                     </button>
                 </div>
                 <span class="text-white-50 d-none d-md-inline" id="navbar-subtitle">Knowledge Graph Explorer</span>
+                <a href="https://github.com/qualixar/superlocalmemory" target="_blank" class="btn btn-sm btn-outline-light ms-2 d-none d-md-inline-flex align-items-center" style="font-size:0.75rem; gap:4px;" title="Star us on GitHub">
+                    <i class="bi bi-github"></i> <i class="bi bi-star"></i> Star
+                </a>
                 <button class="btn btn-sm theme-toggle" id="refresh-dashboard-btn" onclick="refreshDashboard()" title="Refresh Dashboard" style="padding:4px 8px;">
                     <i class="bi bi-arrow-clockwise" aria-hidden="true"></i>
                 </button>
@@ -894,7 +897,7 @@
                     <div class="row align-items-center mb-2">
                         <div class="col-md-8">
                             <h5 class="mb-0">Interactive Knowledge Graph</h5>
-                            <small class="text-muted">Zoom, pan, click nodes to explore • Powered by Cytoscape.js</small>
+                            <small class="text-muted" id="graph-renderer-label">Zoom, pan, click nodes to explore • <span id="graph-engine-name">Sigma.js WebGL</span></small>
                             <div id="graph-stats" class="mt-2"></div>
                         </div>
                         <div class="col-md-4 text-end">
@@ -902,62 +905,161 @@
                                 <i class="bi bi-arrow-clockwise"></i> Refresh
                             </button>
                             <select class="form-select form-select-sm d-inline-block w-auto" id="graph-max-nodes" onchange="loadGraph()" aria-label="Select maximum number of nodes to display">
-                                <option value="50" selected>50 nodes</option>
+                                <option value="50">50 nodes</option>
                                 <option value="100">100 nodes</option>
-                                <option value="200">200 nodes</option>
+                                <option value="200" selected>200 nodes</option>
                                 <option value="500">500 nodes</option>
+                                <option value="1000">1,000 nodes</option>
+                                <option value="2000">2,000 nodes</option>
+                                <option value="5000">All (5K+)</option>
                             </select>
                         </div>
                     </div>
-                    <div class="row align-items-center">
-                        <div class="col-md-6">
-                            <label class="form-label mb-1 small" for="graph-layout-selector">Layout Algorithm:</label>
-                            <select class="form-select form-select-sm" id="graph-layout-selector" onchange="changeGraphLayout(this.value)" aria-label="Select graph layout algorithm">
-                                <option value="fcose" selected>Force-Directed (Fast)</option>
-                                <option value="cose">Force-Directed (Classic)</option>
-                                <option value="circle">Circular</option>
-                                <option value="grid">Grid</option>
-                                <option value="breadthfirst">Hierarchical</option>
-                                <option value="concentric">Concentric (by Importance)</option>
-                            </select>
+                    <!-- Filter status (kept for cluster/modal integration) -->
+                    <div id="graph-status-container" style="display:none;">
+                        <div id="graph-status-full"></div>
+                        <div id="graph-status-filtered"></div>
+                    </div>
+                </div>
+                <!-- v3.4.1: Sigma.js controls bar -->
+                <div class="row g-2 mb-2" id="sigma-controls">
+                    <div class="col-12">
+                        <div class="d-flex align-items-center gap-2">
+                            <div class="input-group input-group-sm" style="max-width:400px;">
+                                <span class="input-group-text"><i class="bi bi-search"></i></span>
+                                <input type="text" class="form-control" id="sigma-search-input"
+                                       placeholder="Search memories in graph..." aria-label="Search graph nodes"
+                                       oninput="sigmaSearch(this.value)">
+                                <button class="btn btn-outline-secondary" type="button"
+                                        onclick="sigmaClearSearch(); document.getElementById('sigma-search-input').value='';">
+                                    <i class="bi bi-x-lg"></i>
+                                </button>
+                            </div>
+                            <div class="btn-group btn-group-sm">
+                                <button class="btn btn-outline-secondary" onclick="sigmaZoomIn()" title="Zoom In"><i class="bi bi-zoom-in"></i></button>
+                                <button class="btn btn-outline-secondary" onclick="sigmaZoomOut()" title="Zoom Out"><i class="bi bi-zoom-out"></i></button>
+                                <button class="btn btn-outline-secondary" onclick="sigmaResetView()" title="Reset View"><i class="bi bi-arrows-angle-expand"></i></button>
+                            </div>
                         </div>
-                        <div class="col-md-6">
-                            <!-- Clear status indicator - shows what user is viewing -->
-                            <div id="graph-status-container">
-                                <!-- When viewing FULL graph (default state) -->
-                                <div id="graph-status-full" style="display:block;" role="status" aria-live="polite">
-                                    <div class="d-flex align-items-center">
-                                        <span class="text-muted small">
-                                            <i class="bi bi-diagram-3"></i> <span id="graph-status-full-text">Showing all memories</span>
-                                        </span>
-                                        <button class="btn btn-sm btn-outline-secondary ms-2" onclick="loadGraph()" aria-label="Refresh current graph view">
-                                            <i class="bi bi-arrow-clockwise"></i> Refresh
-                                        </button>
-                                    </div>
-                                </div>
+                    </div>
+                </div>
 
-                                <!-- When viewing FILTERED by cluster (show BIG clear button) -->
-                                <div id="graph-status-filtered" style="display:none;" role="status" aria-live="polite">
-                                    <div class="alert alert-info py-2 px-3 mb-0 d-flex align-items-center justify-content-between">
-                                        <span>
-                                            <i class="bi bi-funnel-fill"></i>
-                                            <strong id="graph-filter-description">Viewing Cluster X</strong>
-                                            <span class="small text-muted ms-2" id="graph-filter-count">(X memories)</span>
-                                        </span>
-                                        <button class="btn btn-primary btn-sm ms-3" onclick="clearGraphFilters()" aria-label="Clear filter and show all memories">
-                                            <i class="bi bi-grid-3x3"></i> Show All Memories
-                                        </button>
-                                    </div>
+                <div class="row g-2">
+                    <!-- LEFT PANEL: Legend + Communities + Stats -->
+                    <div class="col-md-2" id="graph-left-panel">
+                        <div class="card p-2" style="font-size:0.8rem; max-height:550px; overflow-y:auto;">
+                            <h6 class="mb-2"><i class="bi bi-palette"></i> Legend</h6>
+                            <div class="mb-1"><span style="display:inline-block;width:12px;height:12px;border-radius:50%;background:#667eea;"></span> Semantic</div>
+                            <div class="mb-1"><span style="display:inline-block;width:12px;height:12px;border-radius:50%;background:#43e97b;"></span> Episodic</div>
+                            <div class="mb-1"><span style="display:inline-block;width:12px;height:12px;border-radius:50%;background:#f093fb;"></span> Opinion</div>
+                            <div class="mb-1"><span style="display:inline-block;width:12px;height:12px;border-radius:50%;background:#4facfe;"></span> Temporal</div>
+                            <hr class="my-2">
+                            <h6 class="mb-2 d-flex justify-content-between align-items-center">
+                                <span><i class="bi bi-collection"></i> Communities</span>
+                                <div class="btn-group btn-group-sm" role="group" aria-label="Community source">
+                                    <input type="radio" class="btn-check" name="community-source" id="community-live" checked onchange="handleCommunitySourceToggle('live')">
+                                    <label class="btn btn-outline-secondary py-0 px-1" style="font-size:0.65rem;" for="community-live">Live</label>
+                                    <input type="radio" class="btn-check" name="community-source" id="community-backend" onchange="handleCommunitySourceToggle('backend')">
+                                    <label class="btn btn-outline-secondary py-0 px-1" style="font-size:0.65rem;" for="community-backend">Backend</label>
                                 </div>
+                            </h6>
+                            <div class="mb-1" id="community-resolution-container">
+                                <label class="form-label small mb-0">Resolution <span id="community-resolution-value" class="text-muted">1.0</span></label>
+                                <input type="range" class="form-range" id="community-resolution" min="0.1" max="3.0" step="0.1" value="1.0"
+                                       oninput="handleResolutionChange(this.value)">
+                            </div>
+                            <div id="community-list-panel">
+                                <div class="text-muted small">No communities detected yet.</div>
+                                <button class="btn btn-sm btn-outline-primary w-100 mt-1" onclick="runCommunityDetection()">
+                                    <i class="bi bi-cpu"></i> Detect
+                                </button>
+                            </div>
+                            <hr class="my-2">
+                            <h6 class="mb-2"><i class="bi bi-graph-up"></i> Stats</h6>
+                            <div id="sigma-stats-panel">
+                                <div class="text-muted">Loading...</div>
+                            </div>
+                            <hr class="my-2">
+                            <h6 class="mb-2"><i class="bi bi-funnel"></i> Filter</h6>
+                            <select class="form-select form-select-sm mb-1" id="sigma-category-filter"
+                                    onchange="sigmaFilterByCategory(this.value)">
+                                <option value="">All types</option>
+                                <option value="semantic">Semantic</option>
+                                <option value="episodic">Episodic</option>
+                                <option value="opinion">Opinion</option>
+                                <option value="temporal">Temporal</option>
+                            </select>
+                        </div>
+                    </div>
+
+                    <!-- CENTER: Graph canvas -->
+                    <div class="col-md-7">
+                        <div id="graph-container"
+                             role="application"
+                             aria-label="Interactive knowledge graph"
+                             aria-describedby="graph-stats"
+                             style="width:100%; height:550px; border:1px solid #dee2e6; border-radius:8px; background:#fafbfc;">
+                        </div>
+                    </div>
+
+                    <!-- RIGHT PANEL: Node detail -->
+                    <div class="col-md-3" id="graph-right-panel">
+                        <div class="card p-2" id="sigma-detail-panel" style="font-size:0.85rem; max-height:550px; overflow-y:auto;">
+                            <h6 class="mb-2"><i class="bi bi-info-circle"></i> Node Detail</h6>
+                            <div id="sigma-detail-content" class="text-muted">
+                                Click a node to see its details, connected memories, and trust score.
                             </div>
                         </div>
                     </div>
                 </div>
-                <div id="graph-container"
-                     role="application"
-                     aria-label="Interactive knowledge graph - use Tab to navigate nodes, Enter to view details, Arrow keys to move between adjacent nodes, Escape to clear filters"
-                     aria-describedby="graph-stats"
-                     style="width:100%; height:600px; border:1px solid #dee2e6; border-radius:8px; background:#f8f9fa;">
+
+                <!-- v3.4.1: Quick Insight Actions -->
+                <div class="row g-2 mt-2">
+                    <div class="col-12">
+                        <div class="card p-2">
+                            <div class="d-flex flex-wrap gap-1 mb-2">
+                                <button class="btn btn-sm btn-outline-info" data-insight-action="changed_this_week">
+                                    <i class="bi bi-clock-history"></i> Changed This Week
+                                </button>
+                                <button class="btn btn-sm btn-outline-warning" data-insight-action="opinions">
+                                    <i class="bi bi-lightbulb"></i> Opinions & Rationale
+                                </button>
+                                <button class="btn btn-sm btn-outline-danger" data-insight-action="contradictions">
+                                    <i class="bi bi-exclamation-triangle"></i> Contradictions
+                                </button>
+                                <button class="btn btn-sm btn-outline-success" data-insight-action="health">
+                                    <i class="bi bi-heart-pulse"></i> Memory Health
+                                </button>
+                                <button class="btn btn-sm btn-outline-primary" data-insight-action="cross_project">
+                                    <i class="bi bi-diagram-3"></i> Cross-Project Links
+                                </button>
+                            </div>
+                            <div id="insight-results" style="max-height:300px; overflow-y:auto;"></div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- v3.4.1: Memory Timeline (D3.js) -->
+                <div id="memory-timeline-panel" class="mt-3">
+                    <div class="d-flex justify-content-between align-items-center mb-2">
+                        <h6 class="mb-0"><i class="bi bi-clock-history"></i> Memory Timeline</h6>
+                        <div class="btn-group btn-group-sm" role="group" id="timeline-zoom-group">
+                            <button type="button" class="btn btn-outline-secondary active" data-zoom="week">Week</button>
+                            <button type="button" class="btn btn-outline-secondary" data-zoom="day">Day</button>
+                            <button type="button" class="btn btn-outline-secondary" data-zoom="month">Month</button>
+                        </div>
+                        <div class="btn-group btn-group-sm ms-2" role="group" id="timeline-group-by-group">
+                            <button type="button" class="btn btn-outline-info active" data-groupby="category">By Type</button>
+                            <button type="button" class="btn btn-outline-info" data-groupby="community">By Community</button>
+                        </div>
+                    </div>
+                    <div id="memory-timeline-chart" style="width:100%;height:280px;overflow:hidden;border:1px solid #dee2e6;border-radius:8px;background:#fafbfc;"></div>
+                    <div class="d-flex gap-3 mt-1 small text-muted">
+                        <span><span class="badge" style="background:#198754">&nbsp;</span> High trust (>=0.7)</span>
+                        <span><span class="badge" style="background:#ffc107">&nbsp;</span> Medium (0.4-0.7)</span>
+                        <span><span class="badge" style="background:#dc3545">&nbsp;</span> Low (<0.4)</span>
+                        <span><span class="badge" style="background:#6c757d">&nbsp;</span> Unknown</span>
+                    </div>
                 </div>
 
                 <!-- Skip link for keyboard users -->
@@ -1830,22 +1932,30 @@
     <!-- D3.js (kept for backward compatibility) -->
     <script src="https://d3js.org/d3.v7.min.js"></script>
 
-    <!-- Cytoscape.js + Extensions (v2.6.5 — interactive graph) -->
-    <script src="https://unpkg.com/cytoscape@3.30.4/dist/cytoscape.min.js"></script>
-    <script src="https://unpkg.com/layout-base@2.0.1/layout-base.js"></script>
-    <script src="https://unpkg.com/cose-base@2.2.0/cose-base.js"></script>
-    <script src="https://unpkg.com/cytoscape-fcose@2.2.0/cytoscape-fcose.js"></script>
-    <link href="https://unpkg.com/cytoscape-navigator@1.3.3/cytoscape.js-navigator.css" rel="stylesheet" type="text/css" />
-    <script src="https://unpkg.com/cytoscape-navigator@1.3.3/cytoscape-navigator.js"></script>
+    <!-- Cytoscape.js REMOVED in v3.4.1 — replaced by Sigma.js WebGL -->
+
+    <!-- Sigma.js v3 + graphology (v3.4.1 — WebGL graph) -->
+    <script src="https://cdn.jsdelivr.net/npm/graphology@0.25.4/dist/graphology.umd.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/graphology-library@0.8.0/dist/graphology-library.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/sigma@2.4.0/build/sigma.min.js"></script>
 
     <!-- Modular JS (v2.5 — split from monolith app.js) -->
     <script src="static/js/core.js"></script>
 
-    <!-- Graph Visualization Scripts (v2.6.5 - Modular) -->
-    <script src="static/js/graph-core.js"></script>
-    <script src="static/js/graph-filters.js"></script>
+    <!-- v3.4.1: Event bus (must load before graph + chat) -->
+    <script src="static/js/graph-event-bus.js"></script>
+    <!-- v3.4.1: Sigma.js Knowledge Graph (defines globals: filterState, loadGraph, renderGraph) -->
+    <script src="static/js/knowledge-graph.js"></script>
+    <!-- Shared UI utilities (showLoadingSpinner, updateGraphStats, etc.) -->
     <script src="static/js/graph-ui.js"></script>
-    <script src="static/js/graph-interactions.js"></script>
+    <!-- Filter functions (filterByCluster, filterByEntity — used by clusters.js, modal.js) -->
+    <script src="static/js/graph-filters.js"></script>
+    <!-- v3.4.1: Ask My Memory chat interface -->
+    <script src="static/js/memory-chat.js"></script>
+    <!-- v3.4.1: Quick Insight Actions (5 one-click intelligence buttons) -->
+    <script src="static/js/quick-actions.js"></script>
+    <!-- v3.4.1: Memory Timeline (D3 time axis, zoom, trust colors) -->
+    <script src="static/js/memory-timeline.js"></script>
 
     <script src="static/js/memories.js"></script>
     <script src="static/js/search.js"></script>
@@ -1872,8 +1982,8 @@
     <script src="static/js/fact-detail.js"></script>
 
     <footer>
-        <p>SuperLocalMemory V3 by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a></p>
-        <p><a href="https://github.com/qualixar/superlocalmemory">GitHub Repository</a> | Elastic License 2.0</p>
+        <p>SuperLocalMemory V3 by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a> · <a href="https://qualixar.com">Qualixar</a></p>
+        <p><a href="https://github.com/qualixar/superlocalmemory">GitHub</a> · AGPL-3.0-or-later · <a href="https://github.com/qualixar/superlocalmemory/stargazers">⭐ Star us on GitHub</a></p>
     </footer>
 </body>
 </html>

package/src/superlocalmemory/ui/js/graph-event-bus.js

@@ -0,0 +1,83 @@
+// SuperLocalMemory v3.4.1 — Graph Event Bus
+// Copyright (c) 2026 Varun Pratap Bhardwaj — AGPL-3.0-or-later
+// CustomEvent-based pub/sub for graph ↔ chat bidirectional linking.
+// Renderer-agnostic — works regardless of which graph engine is active.
+
+var SLMEventBus = (function() {
+    var _debounceTimers = {};
+
+    function publish(eventName, detail) {
+        window.dispatchEvent(new CustomEvent(eventName, {
+            detail: Object.freeze(detail || {}),
+        }));
+    }
+
+    function publishDebounced(eventName, detail, delayMs) {
+        if (_debounceTimers[eventName]) {
+            clearTimeout(_debounceTimers[eventName]);
+        }
+        _debounceTimers[eventName] = setTimeout(function() {
+            publish(eventName, detail);
+            _debounceTimers[eventName] = null;
+        }, delayMs || 200);
+    }
+
+    function subscribe(eventName, callback) {
+        window.addEventListener(eventName, function(e) {
+            callback(e.detail);
+        });
+    }
+
+    return { publish: publish, publishDebounced: publishDebounced, subscribe: subscribe };
+})();
+
+// Expose globally
+window.SLMEventBus = SLMEventBus;
+
+// ============================================================================
+// EVENT DEFINITIONS
+// ============================================================================
+// slm:graph:nodeClicked     — { factId, label }   — graph node was clicked
+// slm:graph:highlightNode   — { factId }           — highlight a node in graph
+// slm:chat:citationClicked  — { factId }           — citation badge clicked in chat
+// slm:chat:queryAbout       — { query }             — fill chat input and send
+
+// ============================================================================
+// WIRING: Graph → Chat
+// ============================================================================
+
+SLMEventBus.subscribe('slm:graph:nodeClicked', function(detail) {
+    // Double-click on graph node → fill chat with query about that node
+    // (Single click handled by openSigmaNodeDetail in knowledge-graph.js)
+});
+
+SLMEventBus.subscribe('slm:chat:queryAbout', function(detail) {
+    if (!detail || !detail.query) return;
+    var input = document.getElementById('chat-input');
+    if (input) {
+        input.value = detail.query;
+        // Switch to chat panel if on detail panel
+        if (typeof showChatPanel === 'function') showChatPanel();
+        // Auto-send
+        if (typeof sendChatFromInput === 'function') sendChatFromInput();
+    }
+});
+
+// ============================================================================
+// WIRING: Chat → Graph
+// ============================================================================
+
+SLMEventBus.subscribe('slm:chat:citationClicked', function(detail) {
+    if (!detail || !detail.factId) return;
+    // Highlight the cited node in the graph
+    if (typeof sigmaHighlightNode === 'function') {
+        sigmaHighlightNode(detail.factId);
+    }
+});
+
+SLMEventBus.subscribe('slm:graph:highlightNode', function(detail) {
+    if (!detail || !detail.factId) return;
+    if (typeof sigmaHighlightNode === 'function') {
+        sigmaHighlightNode(detail.factId);
+    }
+});

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

@@ -123,7 +123,7 @@ function setupGraphEventListeners() {
         graphTab.addEventListener('shown.bs.tab', function(event) {
             console.log('[Event] Knowledge Graph tab SHOWN (tab switch)');
 
-            if (cy) {
+            if (cy || sigmaInstance) {
                 // Graph already exists - user is returning to KG tab from another tab
                 // Clear filter and reload to show full graph
                 console.log('[Event] Returning to KG tab from another tab - clearing filter');