superlocalmemory 3.4.5 → 3.4.7

package/src/superlocalmemory/storage/schema_v343.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3.4.3 "The Unified Brain" — Schema Extensions.
@@ -151,6 +151,80 @@ CREATE TABLE IF NOT EXISTS schema_version (
 # Migration runner
 # ---------------------------------------------------------------------------
 
+# ---------------------------------------------------------------------------
+# DDL — v3.4.6: Mesh Connected Brain (broadcast, project routing, offline queue)
+# ---------------------------------------------------------------------------
+
+_MESH_V346_ALTERS = [
+    "ALTER TABLE mesh_peers ADD COLUMN project_path TEXT DEFAULT ''",
+    "ALTER TABLE mesh_peers ADD COLUMN agent_type TEXT DEFAULT 'unknown'",
+    "ALTER TABLE mesh_messages ADD COLUMN expires_at TEXT DEFAULT NULL",
+    "ALTER TABLE mesh_messages ADD COLUMN target_type TEXT DEFAULT 'peer'",
+    "ALTER TABLE mesh_messages ADD COLUMN project_path TEXT DEFAULT ''",
+]
+
+_MESH_V346_DDL = """
+-- Read tracking for broadcast/project messages (each peer tracks own reads)
+CREATE TABLE IF NOT EXISTS mesh_reads (
+    message_id INTEGER NOT NULL,
+    peer_id TEXT NOT NULL,
+    read_at TEXT NOT NULL,
+    PRIMARY KEY (message_id, peer_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_mesh_messages_target
+    ON mesh_messages(target_type, project_path);
+CREATE INDEX IF NOT EXISTS idx_mesh_messages_expires
+    ON mesh_messages(expires_at);
+CREATE INDEX IF NOT EXISTS idx_mesh_peers_project
+    ON mesh_peers(project_path);
+"""
+
+
+def apply_v346_schema(db_path: str | sqlite3.Connection) -> dict:
+    """Apply v3.4.6 mesh enhancements. Idempotent."""
+    result = {"applied": [], "errors": []}
+
+    if isinstance(db_path, sqlite3.Connection):
+        conn = db_path
+        own_connection = False
+    else:
+        conn = sqlite3.connect(str(db_path))
+        own_connection = True
+
+    try:
+        for alter_sql in _MESH_V346_ALTERS:
+            try:
+                conn.execute(alter_sql)
+                col_name = alter_sql.split("ADD COLUMN")[1].strip().split()[0]
+                result["applied"].append(col_name)
+            except sqlite3.OperationalError:
+                pass  # Column already exists
+
+        try:
+            conn.executescript(_MESH_V346_DDL)
+            result["applied"].append("mesh_reads table + indexes")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"mesh_v346: {e}")
+
+        conn.execute(
+            "INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)",
+            ("3.4.6", __import__("datetime").datetime.now().isoformat()),
+        )
+        conn.commit()
+
+        if result["applied"]:
+            logger.info("Schema v3.4.6 applied: %s", ", ".join(result["applied"]))
+
+    except Exception as e:
+        result["errors"].append(f"fatal: {e}")
+    finally:
+        if own_connection:
+            conn.close()
+
+    return result
+
+
 def apply_v343_schema(db_path: str | sqlite3.Connection) -> dict:
     """Apply all v3.4.3 schema changes. Idempotent — safe to call multiple times.
 

package/src/superlocalmemory/storage/schema_v347.py

@@ -0,0 +1,136 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+# Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
+
+"""SuperLocalMemory V3.4.7 "The Learning Brain" — Schema Extensions.
+
+New tables for two-way learning:
+  - tool_events: Passive tool usage telemetry
+  - behavioral_assertions: Learned patterns with confidence evolution
+
+Design rules (inherited):
+  - CREATE IF NOT EXISTS for idempotency
+  - profile_id where applicable
+  - Never ALTER existing column types
+
+Part of Qualixar | Author: Varun Pratap Bhardwaj
+"""
+
+from __future__ import annotations
+
+import logging
+import sqlite3
+
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# DDL — Tool Events (passive telemetry for learning)
+# ---------------------------------------------------------------------------
+
+_TOOL_EVENTS_DDL = """
+CREATE TABLE IF NOT EXISTS tool_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT NOT NULL,
+    profile_id TEXT DEFAULT 'default',
+    project_path TEXT DEFAULT '',
+    tool_name TEXT NOT NULL,
+    event_type TEXT NOT NULL DEFAULT 'invoke',
+    input_summary TEXT DEFAULT '',
+    output_summary TEXT DEFAULT '',
+    duration_ms INTEGER DEFAULT 0,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_events_tool
+    ON tool_events(tool_name, created_at);
+CREATE INDEX IF NOT EXISTS idx_tool_events_session
+    ON tool_events(session_id);
+CREATE INDEX IF NOT EXISTS idx_tool_events_project
+    ON tool_events(project_path);
+"""
+
+# ---------------------------------------------------------------------------
+# DDL — Behavioral Assertions (learned patterns with confidence)
+# ---------------------------------------------------------------------------
+
+_ASSERTIONS_DDL = """
+CREATE TABLE IF NOT EXISTS behavioral_assertions (
+    id TEXT PRIMARY KEY,
+    profile_id TEXT NOT NULL DEFAULT 'default',
+    project_path TEXT DEFAULT '',
+    trigger_condition TEXT NOT NULL,
+    action TEXT NOT NULL,
+    category TEXT DEFAULT 'workflow',
+    confidence REAL DEFAULT 0.3,
+    evidence_fact_ids TEXT DEFAULT '[]',
+    evidence_count INTEGER DEFAULT 1,
+    reinforcement_count INTEGER DEFAULT 0,
+    contradiction_count INTEGER DEFAULT 0,
+    last_reinforced_at TEXT,
+    last_contradicted_at TEXT,
+    source TEXT DEFAULT 'auto',
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_assertions_confidence
+    ON behavioral_assertions(confidence DESC);
+CREATE INDEX IF NOT EXISTS idx_assertions_project
+    ON behavioral_assertions(project_path, profile_id);
+CREATE INDEX IF NOT EXISTS idx_assertions_category
+    ON behavioral_assertions(category);
+"""
+
+# ---------------------------------------------------------------------------
+# Migration runner
+# ---------------------------------------------------------------------------
+
+def apply_v347_schema(db_path: str | sqlite3.Connection) -> dict:
+    """Apply all v3.4.7 schema changes. Idempotent — safe to call multiple times."""
+    result = {"applied": [], "errors": []}
+
+    if isinstance(db_path, sqlite3.Connection):
+        conn = db_path
+        own_connection = False
+    else:
+        conn = sqlite3.connect(str(db_path))
+        own_connection = True
+
+    try:
+        # Tool events table
+        try:
+            conn.executescript(_TOOL_EVENTS_DDL)
+            result["applied"].append("tool_events table + indexes")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"tool_events: {e}")
+
+        # Behavioral assertions table
+        try:
+            conn.executescript(_ASSERTIONS_DDL)
+            result["applied"].append("behavioral_assertions table + indexes")
+        except sqlite3.OperationalError as e:
+            result["errors"].append(f"behavioral_assertions: {e}")
+
+        # Mark version
+        try:
+            conn.execute(
+                "INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)",
+                ("3.4.7", __import__("datetime").datetime.now().isoformat()),
+            )
+        except sqlite3.OperationalError:
+            pass  # schema_version table might not exist yet
+
+        conn.commit()
+
+        if result["applied"]:
+            logger.info("Schema v3.4.7 applied: %s", ", ".join(result["applied"]))
+
+    except Exception as e:
+        result["errors"].append(f"fatal: {e}")
+        logger.error("Schema v3.4.7 migration failed: %s", e)
+    finally:
+        if own_connection:
+            conn.close()
+
+    return result

package/src/superlocalmemory/storage/v2_migrator.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """V2 to V3 database migration.

package/src/superlocalmemory/trust/gate.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Trust Gate (Pre-Operation Checks).

package/src/superlocalmemory/trust/provenance.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Provenance Tracking.

package/src/superlocalmemory/trust/scorer.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Bayesian Trust Scorer (Beta Distribution).

package/src/superlocalmemory/trust/signals.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Trust Signal Recorder with Burst Detection.

package/src/superlocalmemory/ui/js/behavioral.js

@@ -1,6 +1,6 @@
-// SPDX-License-Identifier: Elastic-2.0
+// SPDX-License-Identifier: AGPL-3.0-or-later
 // Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
-// Behavioral Learning tab — outcomes, patterns, cross-project transfers (v2.8)
+// Behavioral Learning tab — assertions, outcomes, patterns, tool events (v3.4.7)
 // NOTE: All dynamic values use textContent or escapeHtml() from core.js before DOM insertion.
 
 var _behavioralData = null;
@@ -12,7 +12,7 @@ async function loadBehavioral() {
         _behavioralData = data;
 
         if (!data.available) {
-            showEmpty('behavioral-patterns-content', 'lightbulb', 'Behavioral learning not available. Upgrade to v2.8.');
+            showEmpty('behavioral-patterns-content', 'lightbulb', 'Behavioral learning not available.');
             return;
         }
 
@@ -21,6 +21,22 @@ async function loadBehavioral() {
         renderBehavioralTransfers(data);
         renderBehavioralOutcomes(data);
 
+        // v3.4.7: Load behavioral assertions (learned patterns with confidence)
+        try {
+            var assertResp = await fetch('/api/behavioral/assertions');
+            var assertData = await assertResp.json();
+            renderBehavioralAssertions(assertData);
+            // Update stats with assertion count
+            animateCounter('bh-patterns-count', (data.stats || {}).patterns_count + (assertData.count || 0));
+        } catch (e) { console.debug('assertions load:', e); }
+
+        // v3.4.7: Load tool events summary
+        try {
+            var evResp = await fetch('/api/behavioral/tool-events?limit=20');
+            var evData = await evResp.json();
+            renderToolEventsSummary(evData);
+        } catch (e) { console.debug('tool events load:', e); }
+
         var badge = document.getElementById('behavioral-profile-badge');
         if (badge) badge.textContent = data.active_profile || 'default';
     } catch (error) {
@@ -235,6 +251,161 @@ function renderBehavioralOutcomes(data) {
     container.appendChild(table);
 }
 
+// v3.4.7: Render behavioral assertions (learned patterns with confidence evolution)
+function renderBehavioralAssertions(data) {
+    var container = document.getElementById('behavioral-patterns-content');
+    if (!container) return;
+    var assertions = data.assertions || [];
+    if (assertions.length === 0) return; // Don't clear existing patterns
+
+    // Add assertions section header
+    var header = document.createElement('div');
+    header.className = 'd-flex align-items-center mt-3 mb-2';
+    header.innerHTML = '<span class="badge bg-info me-2">NEW</span><strong>Behavioral Assertions (v3.4.7)</strong>';
+    container.appendChild(header);
+
+    for (var i = 0; i < assertions.length; i++) {
+        var a = assertions[i];
+        var confPct = Math.round((a.confidence || 0) * 100);
+        var barColor = confPct >= 70 ? 'bg-success' : (confPct >= 40 ? 'bg-warning' : 'bg-secondary');
+
+        var card = document.createElement('div');
+        card.className = 'card mb-2';
+        card.style.cursor = 'pointer';
+        card.style.border = '1px solid rgba(255,255,255,0.1)';
+        card.style.background = 'rgba(255,255,255,0.03)';
+
+        var body = document.createElement('div');
+        body.className = 'card-body py-2 px-3';
+
+        // Top row: trigger → action
+        var topRow = document.createElement('div');
+        topRow.className = 'd-flex justify-content-between align-items-start';
+
+        var triggerSpan = document.createElement('div');
+        triggerSpan.className = 'small';
+        var trigBadge = document.createElement('span');
+        trigBadge.className = 'badge bg-secondary me-1';
+        trigBadge.textContent = a.trigger_condition || '';
+        var arrow = document.createElement('span');
+        arrow.className = 'text-muted mx-1';
+        arrow.textContent = '→';
+        var actionSpan = document.createElement('span');
+        actionSpan.textContent = a.action || '';
+        triggerSpan.appendChild(trigBadge);
+        triggerSpan.appendChild(arrow);
+        triggerSpan.appendChild(actionSpan);
+
+        var confBadge = document.createElement('span');
+        confBadge.className = 'badge ' + barColor;
+        confBadge.textContent = confPct + '%';
+        confBadge.title = 'Confidence: ' + confPct + '% (reinforced ' + (a.reinforcement_count || 0) + 'x, contradicted ' + (a.contradiction_count || 0) + 'x)';
+
+        topRow.appendChild(triggerSpan);
+        topRow.appendChild(confBadge);
+        body.appendChild(topRow);
+
+        // Bottom row: category + evidence + confidence bar
+        var bottomRow = document.createElement('div');
+        bottomRow.className = 'd-flex align-items-center mt-1';
+        var catBadge = document.createElement('span');
+        catBadge.className = 'badge bg-outline-secondary me-2 small';
+        catBadge.style.border = '1px solid rgba(255,255,255,0.2)';
+        catBadge.textContent = a.category || '';
+        var evidenceSpan = document.createElement('small');
+        evidenceSpan.className = 'text-muted me-2';
+        evidenceSpan.textContent = (a.evidence_count || 0) + ' evidence';
+        var progress = document.createElement('div');
+        progress.className = 'progress flex-grow-1';
+        progress.style.height = '4px';
+        var bar = document.createElement('div');
+        bar.className = 'progress-bar ' + barColor;
+        bar.style.width = confPct + '%';
+        progress.appendChild(bar);
+        bottomRow.appendChild(catBadge);
+        bottomRow.appendChild(evidenceSpan);
+        bottomRow.appendChild(progress);
+        body.appendChild(bottomRow);
+
+        card.appendChild(body);
+
+        // Click to expand details
+        (function(assertion, cardEl) {
+            cardEl.addEventListener('click', function() {
+                var existing = cardEl.querySelector('.assertion-detail');
+                if (existing) { existing.remove(); return; }
+                var detail = document.createElement('div');
+                detail.className = 'assertion-detail px-3 pb-2 small text-muted';
+                detail.innerHTML = '<div>ID: <code>' + escapeHtml(assertion.id) + '</code></div>' +
+                    '<div>Source: ' + escapeHtml(assertion.source || 'auto') + '</div>' +
+                    '<div>Project: ' + escapeHtml(assertion.project_path || 'global') + '</div>' +
+                    '<div>Created: ' + escapeHtml(formatDate(assertion.created_at || '')) + '</div>' +
+                    '<div>Reinforced: ' + (assertion.reinforcement_count || 0) + 'x | Contradicted: ' + (assertion.contradiction_count || 0) + 'x</div>';
+                cardEl.appendChild(detail);
+            });
+        })(a, card);
+
+        container.appendChild(card);
+    }
+}
+
+// v3.4.7: Render tool events summary in behavioral tab
+function renderToolEventsSummary(data) {
+    var container = document.getElementById('behavioral-outcomes-content');
+    if (!container) return;
+    var events = data.events || [];
+    if (events.length === 0) return;
+
+    // Add tool events section
+    var header = document.createElement('div');
+    header.className = 'd-flex align-items-center mt-3 mb-2';
+    header.innerHTML = '<span class="badge bg-info me-2">NEW</span><strong>Recent Tool Events</strong> <small class="text-muted ms-2">(' + data.count + ' shown)</small>';
+    container.appendChild(header);
+
+    var table = document.createElement('table');
+    table.className = 'table table-sm table-hover mb-0';
+    var thead = document.createElement('thead');
+    var headRow = document.createElement('tr');
+    ['Tool', 'Event', 'Time'].forEach(function(h) {
+        var th = document.createElement('th');
+        th.textContent = h;
+        headRow.appendChild(th);
+    });
+    thead.appendChild(headRow);
+    table.appendChild(thead);
+
+    var tbody = document.createElement('tbody');
+    for (var i = 0; i < Math.min(events.length, 10); i++) {
+        var ev = events[i];
+        var row = document.createElement('tr');
+        row.style.cursor = 'pointer';
+
+        var toolCell = document.createElement('td');
+        var toolBadge = document.createElement('code');
+        toolBadge.className = 'small';
+        toolBadge.textContent = ev.tool_name || '';
+        toolCell.appendChild(toolBadge);
+        row.appendChild(toolCell);
+
+        var typeCell = document.createElement('td');
+        var typeBadge = document.createElement('span');
+        var typeColors = { invoke: 'bg-primary', complete: 'bg-success', error: 'bg-danger', correction: 'bg-warning' };
+        typeBadge.className = 'badge ' + (typeColors[ev.event_type] || 'bg-secondary');
+        typeBadge.textContent = ev.event_type || '';
+        typeCell.appendChild(typeBadge);
+        row.appendChild(typeCell);
+
+        var dateCell = document.createElement('td');
+        dateCell.className = 'small text-muted';
+        dateCell.textContent = formatDate(ev.created_at || '');
+        row.appendChild(dateCell);
+
+        tbody.appendChild(row);
+    }
+    table.appendChild(tbody);
+    container.appendChild(table);
+}
+
 async function reportOutcome() {
     var memIdsInput = document.getElementById('bh-memory-ids');
     var outcomeSelect = document.getElementById('bh-outcome');

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.4.4
+Version: 3.4.7
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -101,6 +101,10 @@ Dynamic: license-file
   <a href="#dual-interface-mcp--cli"><img src="https://img.shields.io/badge/CLI-Agent--Native-green?style=for-the-badge" alt="CLI Agent-Native"/></a>
 </p>
 
+<p align="center">
+  <video src="https://github.com/user-attachments/assets/c3b54a1d-f62a-4ea7-bba7-900435e7b3ab" width="800" autoplay loop muted playsinline></video>
+</p>
+
 ---
 
 ## Why SuperLocalMemory?
@@ -418,17 +422,6 @@ Built-in compliance tools: GDPR Article 15/17 export + complete erasure, tamper-
 slm dashboard    # Opens at http://localhost:8765
 ```
 
-<details open>
-<summary><strong>Dashboard Demo — v3.4.4 "Neural Glass"</strong> (click to collapse)</summary>
-<p align="center">
-  <a href="https://github.com/qualixar/superlocalmemory/issues/15">
-    <video src="https://github.com/user-attachments/assets/c3b54a1d-f62a-4ea7-bba7-900435e7b3ab" width="800" autoplay loop muted playsinline>
-      Your browser does not support the video tag. <a href="https://github.com/qualixar/superlocalmemory/issues/15">Watch the demo</a>.
-    </video>
-  </a>
-</p>
-</details>
-
 **v3.4.4 "Neural Glass":** 21-tab sidebar dashboard with light + dark theme. Knowledge Graph (Sigma.js WebGL, community detection), Health Monitor, Entity Explorer (1,300+ entities), Mesh Peers (P2P agent communication), Ingestion Status (Gmail/Calendar/Transcript management), Privacy blur mode. Always-on daemon with auto-start. 8 mesh MCP tools built-in. Cross-platform: macOS + Windows + Linux. All data stays local.
 
 ---

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

@@ -131,6 +131,7 @@ src/superlocalmemory/ingestion/parsers.py
 src/superlocalmemory/ingestion/transcript_adapter.py
 src/superlocalmemory/learning/__init__.py
 src/superlocalmemory/learning/adaptive.py
+src/superlocalmemory/learning/assertion_miner.py
 src/superlocalmemory/learning/behavioral.py
 src/superlocalmemory/learning/behavioral_listener.py
 src/superlocalmemory/learning/bootstrap.py
@@ -170,6 +171,7 @@ src/superlocalmemory/mcp/tools.py
 src/superlocalmemory/mcp/tools_active.py
 src/superlocalmemory/mcp/tools_code_graph.py
 src/superlocalmemory/mcp/tools_core.py
+src/superlocalmemory/mcp/tools_learning.py
 src/superlocalmemory/mcp/tools_mesh.py
 src/superlocalmemory/mcp/tools_v28.py
 src/superlocalmemory/mcp/tools_v3.py
@@ -241,6 +243,7 @@ src/superlocalmemory/storage/schema.py
 src/superlocalmemory/storage/schema_code_graph.py
 src/superlocalmemory/storage/schema_v32.py
 src/superlocalmemory/storage/schema_v343.py
+src/superlocalmemory/storage/schema_v347.py
 src/superlocalmemory/storage/v2_migrator.py
 src/superlocalmemory/trust/__init__.py
 src/superlocalmemory/trust/gate.py