superlocalmemory 3.4.0 → 3.4.1

package/src/superlocalmemory/ui/js/quick-actions.js

@@ -0,0 +1,334 @@
+// SuperLocalMemory v3.4.1 — Quick Insight Actions
+// Copyright (c) 2026 Varun Pratap Bhardwaj — AGPL-3.0-or-later
+// 5 one-click intelligence buttons. Safe DOM construction (HR-08).
+
+// ============================================================================
+// INIT
+// ============================================================================
+
+function initQuickActions() {
+    var buttons = document.querySelectorAll('[data-insight-action]');
+    buttons.forEach(function(btn) {
+        btn.addEventListener('click', function() {
+            var action = btn.getAttribute('data-insight-action');
+            fetchInsight(action);
+        });
+    });
+}
+
+// ============================================================================
+// FETCH + DISPATCH
+// ============================================================================
+
+function fetchInsight(actionName) {
+    var resultsDiv = document.getElementById('insight-results');
+    if (!resultsDiv) return;
+
+    // Show loading
+    resultsDiv.innerHTML = '';
+    var spinner = document.createElement('div');
+    spinner.className = 'text-center py-3';
+    spinner.innerHTML = '<div class="spinner-border spinner-border-sm text-primary"></div> Loading...';
+    resultsDiv.appendChild(spinner);
+
+    // Highlight active button
+    document.querySelectorAll('[data-insight-action]').forEach(function(b) {
+        b.classList.remove('active');
+    });
+    var activeBtn = document.querySelector('[data-insight-action="' + actionName + '"]');
+    if (activeBtn) activeBtn.classList.add('active');
+
+    fetch('/api/v3/insights/' + actionName)
+        .then(function(r) {
+            if (!r.ok) throw new Error('HTTP ' + r.status);
+            return r.json();
+        })
+        .then(function(data) {
+            resultsDiv.innerHTML = '';
+            renderInsightResult(actionName, data, resultsDiv);
+        })
+        .catch(function(e) {
+            resultsDiv.innerHTML = '';
+            var alert = document.createElement('div');
+            alert.className = 'alert alert-danger small';
+            alert.textContent = 'Failed to fetch insights: ' + e.message;
+            resultsDiv.appendChild(alert);
+        });
+}
+
+function renderInsightResult(action, data, container) {
+    if (data.count === 0 && action !== 'health') {
+        var empty = document.createElement('div');
+        empty.className = 'text-muted small py-2';
+        empty.textContent = 'No results for "' + action.replace(/_/g, ' ') + '".';
+        container.appendChild(empty);
+        return;
+    }
+
+    // Header with close button
+    var header = document.createElement('div');
+    header.className = 'd-flex justify-content-between align-items-center mb-2';
+    var title = document.createElement('strong');
+    title.className = 'small';
+    title.textContent = formatActionName(action) + ' (' + data.count + ')';
+    header.appendChild(title);
+    var closeBtn = document.createElement('button');
+    closeBtn.className = 'btn-close btn-close-sm';
+    closeBtn.setAttribute('aria-label', 'Close');
+    closeBtn.addEventListener('click', clearInsightResults);
+    header.appendChild(closeBtn);
+    container.appendChild(header);
+
+    var renderers = {
+        changed_this_week: renderChangedThisWeek,
+        opinions: renderOpinions,
+        contradictions: renderContradictions,
+        health: renderHealth,
+        cross_project: renderCrossProject,
+    };
+    var renderer = renderers[action];
+    if (renderer) renderer(data, container);
+}
+
+// ============================================================================
+// RENDERERS (safe DOM — createElement/textContent only, no innerHTML)
+// ============================================================================
+
+function renderChangedThisWeek(data, container) {
+    var nodeIds = [];
+    (data.items || []).forEach(function(item) {
+        var card = document.createElement('div');
+        card.className = 'border rounded p-2 mb-1';
+        card.style.fontSize = '0.78rem';
+
+        var badge = document.createElement('span');
+        badge.className = 'badge bg-info me-1';
+        badge.textContent = item.fact_type || 'fact';
+        card.appendChild(badge);
+
+        var content = document.createElement('span');
+        content.textContent = item.content;
+        card.appendChild(content);
+
+        var ts = document.createElement('div');
+        ts.className = 'text-muted mt-1';
+        ts.style.fontSize = '0.7rem';
+        ts.textContent = formatTimestamp(item.created_at);
+        card.appendChild(ts);
+
+        container.appendChild(card);
+        if (item.fact_id) nodeIds.push(item.fact_id);
+    });
+    highlightNodesInGraph(nodeIds);
+}
+
+function renderOpinions(data, container) {
+    var nodeIds = [];
+    (data.items || []).forEach(function(item) {
+        var card = document.createElement('div');
+        card.className = 'border-start border-3 border-warning p-2 mb-1';
+        card.style.fontSize = '0.78rem';
+
+        var conf = document.createElement('span');
+        conf.className = 'badge bg-warning text-dark me-1';
+        conf.textContent = (item.confidence * 100).toFixed(0) + '%';
+        card.appendChild(conf);
+
+        var content = document.createElement('span');
+        content.textContent = item.content;
+        card.appendChild(content);
+
+        var ts = document.createElement('div');
+        ts.className = 'text-muted mt-1';
+        ts.style.fontSize = '0.7rem';
+        ts.textContent = formatTimestamp(item.created_at);
+        card.appendChild(ts);
+
+        container.appendChild(card);
+        if (item.fact_id) nodeIds.push(item.fact_id);
+    });
+    highlightNodesInGraph(nodeIds);
+}
+
+function renderContradictions(data, container) {
+    var nodeIds = [];
+    (data.items || []).forEach(function(item) {
+        var card = document.createElement('div');
+        card.className = 'alert alert-warning d-flex align-items-start mb-2 py-2';
+
+        var badge = document.createElement('span');
+        badge.className = 'badge bg-danger me-2';
+        badge.textContent = (item.severity * 100).toFixed(0) + '%';
+        card.appendChild(badge);
+
+        var body = document.createElement('div');
+        body.style.fontSize = '0.78rem';
+
+        var src = document.createElement('div');
+        src.textContent = item.source_content;
+        body.appendChild(src);
+
+        var vs = document.createElement('strong');
+        vs.className = 'text-danger';
+        vs.textContent = ' vs ';
+        body.appendChild(vs);
+
+        var tgt = document.createElement('div');
+        tgt.textContent = item.target_content;
+        body.appendChild(tgt);
+
+        card.appendChild(body);
+        container.appendChild(card);
+
+        if (item.source_id) nodeIds.push(item.source_id);
+        if (item.target_id) nodeIds.push(item.target_id);
+    });
+    highlightNodesInGraph(nodeIds);
+}
+
+function renderHealth(data, container) {
+    var health = (data.items && data.items[0]) || {};
+
+    // Trust section
+    var trust = health.trust || {};
+    var trustCard = document.createElement('div');
+    trustCard.className = 'border rounded p-2 mb-2';
+    var trustTitle = document.createElement('strong');
+    trustTitle.className = 'small';
+    trustTitle.textContent = 'Trust Distribution';
+    trustCard.appendChild(trustTitle);
+    ['high', 'medium', 'low'].forEach(function(level) {
+        var row = document.createElement('div');
+        row.className = 'd-flex justify-content-between small';
+        var label = document.createElement('span');
+        label.textContent = level.charAt(0).toUpperCase() + level.slice(1);
+        row.appendChild(label);
+        var val = document.createElement('span');
+        val.className = 'text-muted';
+        val.textContent = trust[level] || 0;
+        row.appendChild(val);
+        trustCard.appendChild(row);
+    });
+    container.appendChild(trustCard);
+
+    // Retention zones
+    var zones = health.retention_zones;
+    if (zones) {
+        var retCard = document.createElement('div');
+        retCard.className = 'border rounded p-2 mb-2';
+        var retTitle = document.createElement('strong');
+        retTitle.className = 'small';
+        retTitle.textContent = 'Retention Zones';
+        retCard.appendChild(retTitle);
+        Object.keys(zones).forEach(function(zone) {
+            var row = document.createElement('div');
+            row.className = 'd-flex justify-content-between small';
+            var label = document.createElement('span');
+            label.textContent = zone;
+            row.appendChild(label);
+            var val = document.createElement('span');
+            val.className = 'text-muted';
+            val.textContent = zones[zone].count + ' (' + (zones[zone].avg_retention * 100).toFixed(0) + '%)';
+            row.appendChild(val);
+            retCard.appendChild(row);
+        });
+        container.appendChild(retCard);
+    }
+
+    // Totals
+    var totals = health.totals || {};
+    var totCard = document.createElement('div');
+    totCard.className = 'border rounded p-2 mb-2';
+    var totTitle = document.createElement('strong');
+    totTitle.className = 'small';
+    totTitle.textContent = 'Memory Totals';
+    totCard.appendChild(totTitle);
+    [['Facts', totals.facts], ['Entities', totals.entities], ['Edges', totals.edges], ['Communities', health.community_count || 0]].forEach(function(pair) {
+        var row = document.createElement('div');
+        row.className = 'd-flex justify-content-between small';
+        var label = document.createElement('span');
+        label.textContent = pair[0];
+        row.appendChild(label);
+        var val = document.createElement('span');
+        val.className = 'text-muted';
+        val.textContent = pair[1] || 0;
+        row.appendChild(val);
+        totCard.appendChild(row);
+    });
+    container.appendChild(totCard);
+}
+
+function renderCrossProject(data, container) {
+    (data.items || []).forEach(function(item) {
+        var card = document.createElement('div');
+        card.className = 'border rounded p-2 mb-1';
+        card.style.fontSize = '0.78rem';
+
+        var name = document.createElement('strong');
+        name.textContent = item.canonical_name;
+        card.appendChild(name);
+
+        var badge = document.createElement('span');
+        badge.className = 'badge bg-primary ms-1';
+        badge.textContent = item.session_count + ' sessions';
+        card.appendChild(badge);
+
+        var detail = document.createElement('div');
+        detail.className = 'text-muted mt-1';
+        detail.style.fontSize = '0.7rem';
+        detail.textContent = (item.entity_type || 'entity') + ' — ' + item.fact_count + ' facts';
+        card.appendChild(detail);
+
+        container.appendChild(card);
+    });
+}
+
+// ============================================================================
+// EVENT BUS INTEGRATION (fire-and-forget — Phase 3 adds listener)
+// ============================================================================
+
+function highlightNodesInGraph(nodeIds) {
+    if (!nodeIds || nodeIds.length === 0) return;
+    window.dispatchEvent(new CustomEvent('slm:graph:highlight', {
+        detail: { nodeIds: nodeIds },
+    }));
+}
+
+function clearInsightResults() {
+    var resultsDiv = document.getElementById('insight-results');
+    if (resultsDiv) resultsDiv.innerHTML = '';
+    // Clear button active state
+    document.querySelectorAll('[data-insight-action]').forEach(function(b) {
+        b.classList.remove('active');
+    });
+    // Clear graph highlights
+    window.dispatchEvent(new CustomEvent('slm:graph:clearHighlight', { detail: {} }));
+}
+
+// ============================================================================
+// HELPERS
+// ============================================================================
+
+function formatActionName(action) {
+    return action.replace(/_/g, ' ').replace(/\b\w/g, function(c) { return c.toUpperCase(); });
+}
+
+function formatTimestamp(ts) {
+    if (!ts) return '';
+    try {
+        var d = new Date(ts);
+        return d.toLocaleDateString() + ' ' + d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+    } catch (_) {
+        return ts;
+    }
+}
+
+// ============================================================================
+// AUTO-INIT
+// ============================================================================
+
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initQuickActions);
+} else {
+    initQuickActions();
+}

package/src/superlocalmemory.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.3.28
+Version: 3.4.1
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
-License: Elastic-2.0
+License: AGPL-3.0-or-later
 Project-URL: Homepage, https://superlocalmemory.com
 Project-URL: Repository, https://github.com/qualixar/superlocalmemory
 Project-URL: Documentation, https://github.com/qualixar/superlocalmemory/wiki
@@ -11,7 +11,7 @@ Project-URL: Issues, https://github.com/qualixar/superlocalmemory/issues
 Keywords: ai-memory,mcp-server,local-first,agent-memory,information-geometry,privacy-first,eu-ai-act
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: Other/Proprietary License
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
@@ -87,7 +87,7 @@ Dynamic: license-file
   <a href="https://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper"/></a>
   <a href="https://pypi.org/project/superlocalmemory/"><img src="https://img.shields.io/pypi/v/superlocalmemory?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"/></a>
   <a href="https://www.npmjs.com/package/superlocalmemory"><img src="https://img.shields.io/npm/v/superlocalmemory?style=for-the-badge&logo=npm&logoColor=white" alt="npm"/></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Elastic%202.0-blue?style=for-the-badge" alt="Elastic License 2.0"/></a>
+  <a href="https://www.gnu.org/licenses/agpl-3.0"><img src="https://img.shields.io/badge/License-AGPL_v3-blue.svg?style=for-the-badge" alt="AGPL v3"/></a>
   <a href="#eu-ai-act-compliance"><img src="https://img.shields.io/badge/EU_AI_Act-Compliant-brightgreen?style=for-the-badge" alt="EU AI Act"/></a>
   <a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/Web-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Website"/></a>
   <a href="#dual-interface-mcp--cli"><img src="https://img.shields.io/badge/MCP-Native-blue?style=for-the-badge" alt="MCP Native"/></a>
@@ -413,20 +413,19 @@ slm dashboard    # Opens at http://localhost:8765
 
 <details open>
 <summary><strong>Dashboard Screenshots</strong> (click to collapse)</summary>
-<p align="center"><img src="docs/screenshots/01-dashboard-main.png" alt="Dashboard" width="600"/></p>
+<p align="center"><img src="docs/screenshots/01-dashboard-main.png" alt="Dashboard Overview — 3,100+ memories, 430K connections" width="600"/></p>
 <p align="center">
-<img src="docs/screenshots/02-knowledge-graph.png" alt="Graph" width="190"/>
-<img src="docs/screenshots/03-math-health.png" alt="Math" width="190"/>
-<img src="docs/screenshots/05-trust-dashboard.png" alt="Trust" width="190"/>
+<img src="docs/screenshots/02-knowledge-graph.png" alt="Knowledge Graph — Sigma.js WebGL with community detection, chat, quick actions, timeline" width="290"/>
+<img src="docs/screenshots/06-graph-communities.png" alt="Graph Communities — Louvain clustering with colored nodes" width="290"/>
 </p>
 <p align="center">
-<img src="docs/screenshots/04-recall-lab.png" alt="Recall" width="190"/>
-<img src="docs/screenshots/06-settings.png" alt="Settings" width="190"/>
-<img src="docs/screenshots/07-memories-blurred.png" alt="Memories" width="190"/>
+<img src="docs/screenshots/03-patterns-learning.png" alt="Patterns — 50 learned behavioral patterns with confidence bars" width="190"/>
+<img src="docs/screenshots/04-learning-dashboard.png" alt="Learning — 722 signals, ML Model phase, tech preferences" width="190"/>
+<img src="docs/screenshots/05-behavioral-analysis.png" alt="Behavioral — pattern analysis with confidence distribution" width="190"/>
 </p>
 </details>
 
-23 tabs: Dashboard, Recall Lab, Knowledge Graph, Memories, Trust Scores, Math Health, Compliance, Learning, IDE Connections, Settings, Memory Lifecycle, Compression, Patterns, and more. Runs locally — no data leaves your machine.
+**v3.4.1 Visual Intelligence:** Sigma.js WebGL knowledge graph with community detection (Louvain/Leiden), 5 quick insight actions, D3 memory timeline, graph-enhanced retrieval (PageRank bias + community boost + contradiction suppression), and 56 auto-mined behavioral patterns. 23+ tabs. Runs locally — no data leaves your machine.
 
 ---
 
@@ -472,7 +471,7 @@ Auto-capture hooks: `slm hooks install` + `slm observe` + `slm session-context`.
 - 17+ IDE integrations (Claude, Cursor, Windsurf, VS Code, JetBrains, Zed, etc.)
 - 35 MCP tools + 7 MCP resources
 - Profile isolation (independent memory spaces)
-- 1400+ tests, Elastic License 2.0, cross-platform (Mac/Linux/Windows)
+- 1400+ tests, AGPL v3, cross-platform (Mac/Linux/Windows)
 - CPU-only — no GPU required
 - Automatic orphaned process cleanup
 
@@ -581,7 +580,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. [Wiki](https://github.com
 
 ## License
 
-Elastic License 2.0. See [LICENSE](LICENSE). Previously MIT — changed April 2026 to protect research IP while keeping the project open for use and contributions.
+GNU Affero General Public License v3.0 (AGPL-3.0). See [LICENSE](LICENSE).
+
+For commercial licensing (closed-source, proprietary, or hosted use), see [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) or contact varun.pratap.bhardwaj@gmail.com.
+
+Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar.
 
 ## Attribution
 

package/src/superlocalmemory.egg-info/SOURCES.txt

@@ -195,15 +195,18 @@ src/superlocalmemory/server/routes/__init__.py
 src/superlocalmemory/server/routes/agents.py
 src/superlocalmemory/server/routes/backup.py
 src/superlocalmemory/server/routes/behavioral.py
+src/superlocalmemory/server/routes/chat.py
 src/superlocalmemory/server/routes/compliance.py
 src/superlocalmemory/server/routes/data_io.py
 src/superlocalmemory/server/routes/events.py
 src/superlocalmemory/server/routes/helpers.py
+src/superlocalmemory/server/routes/insights.py
 src/superlocalmemory/server/routes/learning.py
 src/superlocalmemory/server/routes/lifecycle.py
 src/superlocalmemory/server/routes/memories.py
 src/superlocalmemory/server/routes/profiles.py
 src/superlocalmemory/server/routes/stats.py
+src/superlocalmemory/server/routes/timeline.py
 src/superlocalmemory/server/routes/v3_api.py
 src/superlocalmemory/server/routes/ws.py
 src/superlocalmemory/storage/__init__.py
@@ -236,18 +239,23 @@ src/superlocalmemory/ui/js/events.js
 src/superlocalmemory/ui/js/fact-detail.js
 src/superlocalmemory/ui/js/feedback.js
 src/superlocalmemory/ui/js/graph-core.js
+src/superlocalmemory/ui/js/graph-event-bus.js
 src/superlocalmemory/ui/js/graph-filters.js
 src/superlocalmemory/ui/js/graph-interactions.js
 src/superlocalmemory/ui/js/graph-ui.js
 src/superlocalmemory/ui/js/ide-status.js
 src/superlocalmemory/ui/js/init.js
+src/superlocalmemory/ui/js/knowledge-graph.js
 src/superlocalmemory/ui/js/learning.js
 src/superlocalmemory/ui/js/lifecycle.js
 src/superlocalmemory/ui/js/math-health.js
 src/superlocalmemory/ui/js/memories.js
+src/superlocalmemory/ui/js/memory-chat.js
+src/superlocalmemory/ui/js/memory-timeline.js
 src/superlocalmemory/ui/js/modal.js
 src/superlocalmemory/ui/js/patterns.js
 src/superlocalmemory/ui/js/profiles.js
+src/superlocalmemory/ui/js/quick-actions.js
 src/superlocalmemory/ui/js/recall-lab.js
 src/superlocalmemory/ui/js/search.js
 src/superlocalmemory/ui/js/settings.js