superlocalmemory 2.7.5 → 2.8.0

package/src/webhook_dispatcher.py

@@ -1,16 +1,6 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Webhook Dispatcher
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
-
-Repository: https://github.com/varun369/SuperLocalMemoryV2
-Author: Varun Pratap Bhardwaj (Solution Architect)
-
-NOTICE: This software is protected by MIT License.
-Attribution must be preserved in all copies or derivatives.
-"""
-
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
 """
 WebhookDispatcher — Delivers events via HTTP POST to configured webhook URLs.
 

package/ui/app.js

@@ -1436,7 +1436,7 @@ async function loadAgents() {
             var protoBadge = document.createElement('span');
             var protocolColors = {
                 'mcp': 'bg-primary', 'cli': 'bg-success', 'rest': 'bg-info',
-                'python': 'bg-secondary', 'a2a': 'bg-warning'
+                'python': 'bg-secondary'
             };
             protoBadge.className = 'badge ' + (protocolColors[agent.protocol] || 'bg-secondary');
             protoBadge.textContent = agent.protocol;

package/ui/index.html

@@ -649,6 +649,9 @@
                     </button>
                 </div>
                 <span class="text-white-50 d-none d-md-inline" id="navbar-subtitle">Knowledge Graph Explorer</span>
+                <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>
                 <button class="theme-toggle" id="theme-toggle" onclick="toggleDarkMode()" aria-label="Toggle dark mode">
                     <i class="bi bi-sun-fill" id="theme-icon" aria-hidden="true"></i>
                 </button>

package/ui/js/agents.js

@@ -70,7 +70,7 @@ async function loadAgents() {
             var protoBadge = document.createElement('span');
             var protocolColors = {
                 'mcp': 'bg-primary', 'cli': 'bg-success', 'rest': 'bg-info',
-                'python': 'bg-secondary', 'a2a': 'bg-warning'
+                'python': 'bg-secondary'
             };
             protoBadge.className = 'badge ' + (protocolColors[agent.protocol] || 'bg-secondary');
             protoBadge.textContent = agent.protocol;

package/ui/js/core.js

@@ -182,16 +182,32 @@ async function loadStats() {
     try {
         var response = await fetch('/api/stats');
         var data = await response.json();
-        animateCounter('stat-memories', data.overview.total_memories);
-        animateCounter('stat-clusters', data.overview.total_clusters);
-        animateCounter('stat-nodes', data.overview.graph_nodes);
-        animateCounter('stat-edges', data.overview.graph_edges);
-        populateFilters(data.categories, data.projects);
+        var ov = data.overview || {};
+        animateCounter('stat-memories', ov.total_memories || 0);
+        animateCounter('stat-clusters', ov.total_clusters || 0);
+        animateCounter('stat-nodes', ov.graph_nodes || 0);
+        animateCounter('stat-edges', ov.graph_edges || 0);
+        populateFilters(data.categories || [], data.projects || []);
     } catch (error) {
         console.error('Error loading stats:', error);
+        // On error (fresh install, server starting), show 0 instead of "-"
+        animateCounter('stat-memories', 0);
+        animateCounter('stat-clusters', 0);
+        animateCounter('stat-nodes', 0);
+        animateCounter('stat-edges', 0);
     }
 }
 
+// Refresh entire dashboard — called by the refresh button in the header
+function refreshDashboard() {
+    loadProfiles();
+    loadStats();
+    if (typeof loadGraph === 'function') loadGraph();
+    if (typeof loadMemories === 'function') loadMemories();
+    if (typeof loadEventStats === 'function') loadEventStats();
+    if (typeof loadAgents === 'function') loadAgents();
+}
+
 function populateFilters(categories, projects) {
     var categorySelect = document.getElementById('filter-category');
     var projectSelect = document.getElementById('filter-project');

package/ui/js/profiles.js

@@ -10,15 +10,34 @@ async function loadProfiles() {
         var profiles = data.profiles || [];
         var active = data.active_profile || 'default';
 
-        profiles.forEach(function(p) {
+        if (profiles.length === 0) {
+            // Fresh install fallback — show default profile
             var opt = document.createElement('option');
-            opt.value = p.name;
-            opt.textContent = p.name + (p.memory_count ? ' (' + p.memory_count + ')' : '');
-            if (p.name === active) opt.selected = true;
+            opt.value = 'default';
+            opt.textContent = 'default (0)';
+            opt.selected = true;
             select.appendChild(opt);
-        });
+        } else {
+            profiles.forEach(function(p) {
+                var opt = document.createElement('option');
+                opt.value = p.name;
+                opt.textContent = p.name + ' (' + (p.memory_count || 0) + ')';
+                if (p.name === active) opt.selected = true;
+                select.appendChild(opt);
+            });
+        }
     } catch (error) {
         console.error('Error loading profiles:', error);
+        // On error, ensure dropdown shows at least 'default'
+        var select = document.getElementById('profile-select');
+        if (select && select.options.length === 0) {
+            select.textContent = '';
+            var opt = document.createElement('option');
+            opt.value = 'default';
+            opt.textContent = 'default';
+            opt.selected = true;
+            select.appendChild(opt);
+        }
     }
 }
 
@@ -53,8 +72,11 @@ async function createProfile(nameOverride) {
         showToast('Profile "' + name + '" created');
         var input = document.getElementById('new-profile-name');
         if (input) input.value = '';
-        loadProfiles();
-        loadProfilesTable();
+        // Force reload with small delay to ensure backend has persisted
+        setTimeout(function() {
+            loadProfiles();
+            if (typeof loadProfilesTable === 'function') loadProfilesTable();
+        }, 300);
     } catch (error) {
         console.error('Error creating profile:', error);
         showToast('Error creating profile');

package/ui_server.py

@@ -1,16 +1,6 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Intelligent Local Memory System
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
-
-Repository: https://github.com/varun369/SuperLocalMemoryV2
-Author: Varun Pratap Bhardwaj (Solution Architect)
-
-NOTICE: This software is protected by MIT License.
-Attribution must be preserved in all copies or derivatives.
-"""
-
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
 """
 SuperLocalMemory V2.5.0 - FastAPI UI Server
 App initialization, middleware, static mount, and router registration.
@@ -69,8 +59,6 @@ app.add_middleware(
         "http://127.0.0.1:8765",
         "http://localhost:8417",    # MCP
         "http://127.0.0.1:8417",
-        "http://localhost:8766",    # A2A (planned)
-        "http://127.0.0.1:8766",
     ],
     allow_credentials=True,
     allow_methods=["*"],

package/ATTRIBUTION.md

@@ -1,140 +0,0 @@
-# Attribution & Creator Information
-
-## Solution Architect & Creator
-
-**SuperLocalMemory V2** was architected, designed, and created by:
-
-### **Varun Pratap Bhardwaj**
-- **GitHub**: [@varun369](https://github.com/varun369)
-- **Role**: Solution Architect & Original Creator
-- **Year**: 2026
-
----
-
-## Attribution Requirements
-
-This project is licensed under the MIT License with the following attribution requirements:
-
-### ✅ Required Attribution
-
-1. **In Source Code**: All derivative works MUST retain the copyright notice and attribution headers in source files.
-
-2. **In Documentation**: Any documentation, README, or public-facing materials MUST include:
-   > "Built with SuperLocalMemory V2 by Varun Pratap Bhardwaj"
-
-3. **In Binary Distributions**: Runtime attribution MUST be preserved in:
-   - Startup messages
-   - Version information
-   - Help text
-   - About dialogs
-
-4. **In Modified Versions**: Any modifications or forks MUST clearly state:
-   - Original creator: Varun Pratap Bhardwaj
-   - Link to original repository
-   - Nature of modifications
-
-### ❌ Prohibited Uses
-
-While this project is open source under MIT License, the following are explicitly prohibited:
-
-1. **No Credit Removal**: Removing or obscuring attribution to the original creator
-2. **No Impersonation**: Claiming original authorship or primary creatorship
-3. **No Rebranding**: Releasing as a different project without clear attribution
-4. **No Commercial Misrepresentation**: Selling services based on this work without acknowledging the original creator
-
----
-
-## Architecture Credit
-
-The following innovative architectural decisions and implementations are credited to **Varun Pratap Bhardwaj**:
-
-### Core Architecture
-1. **Dual Integration Pattern**: MCP Server + Agent Skills + CLI (three-tier fallback)
-2. **Zero-Duplication Design**: Single SQLite database shared across all interfaces
-3. **Universal Tool Support**: One installation works with 15+ IDEs and AI tools
-4. **Profile Isolation System**: Complete memory separation via symlink-based profiles
-
-### Technical Innovations
-1. **TF-IDF Entity Extraction**: Automatic knowledge graph building from natural language
-2. **Leiden Clustering**: Community detection for topic grouping
-3. **Three-Method Search**: Semantic + Graph + Full-text hybrid search
-4. **Pattern Learning**: Automatic coding preference detection
-5. **Progressive Disclosure**: Skills system with metadata-first loading
-
-### Integration Strategy
-1. **Auto-Configuration**: Automatic IDE detection and config file updates
-2. **Backup-First Safety**: Original configs preserved before modification
-3. **Comprehensive Fallbacks**: Graceful degradation from MCP → Skills → CLI
-4. **Cross-Platform Design**: Works identically on macOS, Linux, Windows
-
----
-
-## Digital Signature
-
-This section contains cryptographic verification data. **DO NOT REMOVE.**
-
-```
-CREATOR_SIGNATURE_V2
-===================================
-Creator: Varun Pratap Bhardwaj
-GitHub: varun369
-Repository: SuperLocalMemoryV2
-Architecture Date: 2026-01-15
-Release Date: 2026-02-07
-Signature: VBPB-SLM-V2-2026-ARCHITECT
-Verification Hash: sha256:c9f3d1a8b5e2f4c6d8a9b3e7f1c4d6a8b9c3e7f2d5a8c1b4e6f9d2a7c5b8e1
-===================================
-```
-
----
-
-## How to Attribute This Project
-
-### In README Files
-```markdown
-## Built With
-- [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2) by Varun Pratap Bhardwaj
-```
-
-### In Source Code Comments
-```python
-# Based on SuperLocalMemory V2 by Varun Pratap Bhardwaj
-# Original: https://github.com/varun369/SuperLocalMemoryV2
-```
-
-### In Documentation
-```
-This project uses SuperLocalMemory V2, created by Varun Pratap Bhardwaj.
-```
-
-### In About/Help Text
-```
-Powered by SuperLocalMemory V2
-Created by Varun Pratap Bhardwaj
-https://github.com/varun369/SuperLocalMemoryV2
-```
-
----
-
-## Enforcement
-
-Per MIT License terms, attribution is REQUIRED. Violations may result in:
-1. Removal from community support channels
-2. Public notice of attribution violation
-3. Requests to hosting platforms for compliance
-
-**The MIT License requires attribution preservation in all copies and substantial portions of the Software.**
-
----
-
-## Contact
-
-For licensing questions, commercial partnerships, or attribution clarifications:
-- **GitHub Issues**: https://github.com/varun369/SuperLocalMemoryV2/issues
-- **Discussions**: https://github.com/varun369/SuperLocalMemoryV2/discussions
-
----
-
-**Remember**: Open source thrives on proper attribution. Give credit where it's due.
-
-*Last Updated: February 7, 2026*

package/docs/ARCHITECTURE-V2.5.md

@@ -1,190 +0,0 @@
-# SuperLocalMemory V2.5 Architecture — "Your AI Memory Has a Heartbeat"
-
-**Version:** 2.5.0 | **Date:** February 12, 2026 | **Author:** Varun Pratap Bhardwaj
-
----
-
-## What Changed in v2.5
-
-SuperLocalMemory transforms from **passive storage** (filing cabinet) to **active coordination layer** (nervous system). Every memory write, update, delete, or recall now triggers real-time events visible across all connected tools.
-
-### Before v2.5 (Passive)
-```
-Claude writes memory → saved to SQLite → done (silent)
-Cursor reads memory → returned → done (silent)
-```
-
-### After v2.5 (Active)
-```
-Claude writes memory → saved to SQLite → Event Bus fires
-                                           ├── SSE → Dashboard shows it live
-                                           ├── Agent registered in registry
-                                           ├── Trust signal recorded
-                                           ├── Provenance tracked
-                                           └── Webhook dispatched (if configured)
-```
-
----
-
-## System Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    ACCESS LAYER                              │
-│  MCP Server │ CLI │ REST API │ Skills │ Python Import │ A2A  │
-└──────────────────────┬──────────────────────────────────────┘
-                       │
-┌──────────────────────┴──────────────────────────────────────┐
-│                MEMORY STORE V2                               │
-│  ┌─────────────────────────────────────────────────────────┐    │
-│  │  DbConnectionManager (Singleton)                     │    │
-│  │  ├── WAL Mode (concurrent reads + serialized writes) │    │
-│  │  ├── Busy Timeout (5s wait, not fail)                │    │
-│  │  ├── Thread-Local Read Pool                          │    │
-│  │  ├── Serialized Write Queue (threading.Queue)        │    │
-│  │  └── Post-Write Hooks → Event Bus                    │    │
-│  └─────────────────────────────────────────────────────┘    │
-│                                                              │
-│  On every write:                                             │
-│  ├── EventBus.emit() → memory_events table + SSE + WS + WH  │
-│  ├── ProvenanceTracker → created_by, source_protocol columns │
-│  ├── AgentRegistry → agent tracking + write/recall counters  │
-│  └── TrustScorer → signal collection (silent, no enforcement)│
-└──────────────────────────────────────────────────────────────┘
-                       │
-┌──────────────────────┴──────────────────────────────────────┐
-│                    STORAGE LAYER                             │
-│  SQLite (single file: ~/.claude-memory/memory.db)            │
-│                                                              │
-│  Tables:                                                     │
-│  ├── memories (+ provenance columns: created_by,             │
-│  │            source_protocol, trust_score, provenance_chain) │
-│  ├── memory_events (event log with tiered retention)         │
-│  ├── subscriptions (durable + ephemeral event subscriptions) │
-│  ├── agent_registry (connected agents + statistics)          │
-│  ├── trust_signals (trust signal audit trail)                │
-│  ├── graph_nodes, graph_edges, graph_clusters (knowledge graph)│
-│  ├── identity_patterns (learned preferences)                 │
-│  ├── sessions, creator_metadata                              │
-│  └── memories_fts (FTS5 full-text search index)              │
-└──────────────────────────────────────────────────────────────┘
-                       │
-┌──────────────────────┴──────────────────────────────────────┐
-│                    DASHBOARD LAYER                            │
-│  FastAPI UI Server (modular routes)                          │
-│  ├── 8 route modules in routes/ directory                    │
-│  ├── 28 API endpoints                                        │
-│  ├── SSE /events/stream (real-time, cross-process)           │
-│  ├── WebSocket /ws/updates                                   │
-│  ├── 13 modular JS files in ui/js/                           │
-│  └── 8 dashboard tabs (Graph, Memories, Clusters, Patterns,  │
-│       Timeline, Live Events, Agents, Settings)               │
-└──────────────────────────────────────────────────────────────┘
-```
-
----
-
-## New Components (v2.5)
-
-| Component | File | Purpose |
-|-----------|------|---------|
-| **DbConnectionManager** | `src/db_connection_manager.py` | WAL mode, busy timeout, read pool, write queue, post-write hooks |
-| **EventBus** | `src/event_bus.py` | Event emission, persistence, in-memory buffer, tiered retention |
-| **SubscriptionManager** | `src/subscription_manager.py` | Durable + ephemeral event subscriptions with filters |
-| **WebhookDispatcher** | `src/webhook_dispatcher.py` | Background HTTP POST delivery with retry logic |
-| **AgentRegistry** | `src/agent_registry.py` | Agent tracking, write/recall counters, protocol detection |
-| **ProvenanceTracker** | `src/provenance_tracker.py` | Memory origin tracking (who, how, trust, lineage) |
-| **TrustScorer** | `src/trust_scorer.py` | Bayesian trust scoring with decay, burst detection |
-
-## New Database Tables (v2.5)
-
-| Table | Columns | Purpose |
-|-------|---------|---------|
-| `memory_events` | id, event_type, memory_id, source_agent, source_protocol, payload, importance, tier, created_at | Event log with tiered retention |
-| `subscriptions` | id, subscriber_id, channel, filter, webhook_url, durable, last_event_id | Event subscriptions |
-| `agent_registry` | id, agent_id, agent_name, protocol, first_seen, last_seen, memories_written, memories_recalled, trust_score, metadata | Agent tracking |
-| `trust_signals` | id, agent_id, signal_type, delta, old_score, new_score, context, created_at | Trust audit trail |
-
-## New Columns on `memories` Table (v2.5)
-
-| Column | Type | Default | Purpose |
-|--------|------|---------|---------|
-| `created_by` | TEXT | 'user' | Agent ID that created this memory |
-| `source_protocol` | TEXT | 'cli' | Protocol used (mcp, cli, rest, python, a2a) |
-| `trust_score` | REAL | 1.0 | Trust score at creation time |
-| `provenance_chain` | TEXT | '[]' | JSON derivation lineage |
-
----
-
-## Event Types
-
-| Event | Trigger |
-|-------|---------|
-| `memory.created` | New memory written |
-| `memory.updated` | Existing memory modified |
-| `memory.deleted` | Memory removed |
-| `memory.recalled` | Memory retrieved by an agent |
-| `graph.updated` | Knowledge graph rebuilt |
-| `pattern.learned` | New pattern detected |
-| `agent.connected` | New agent connects |
-| `agent.disconnected` | Agent disconnects |
-
-## Event Retention Tiers
-
-| Tier | Window | Kept |
-|------|--------|------|
-| Hot | 0-48h | All events |
-| Warm | 2-14d | Importance >= 5 only |
-| Cold | 14-30d | Daily aggregates |
-| Archive | 30d+ | Pruned (stats in pattern_learner) |
-
----
-
-## Trust Scoring (Silent Collection — v2.5)
-
-All agents start at trust 1.0. Signals adjust the score with a Bayesian decay factor that stabilizes over time.
-
-| Signal | Delta | When |
-|--------|-------|------|
-| `high_importance_write` | +0.015 | Memory with importance >= 7 |
-| `memory_recalled_by_others` | +0.02 | Another agent finds this memory useful |
-| `quick_delete` | -0.03 | Memory deleted within 1 hour |
-| `high_volume_burst` | -0.02 | >20 writes in 5 minutes |
-
-**v2.5:** Silent collection only. **v2.6:** Trust-weighted recall ranking. **v3.0:** Active enforcement.
-
----
-
-## API Endpoints (28 total)
-
-| Route | Method | Module | Purpose |
-|-------|--------|--------|---------|
-| `/` | GET | ui_server.py | Dashboard |
-| `/health` | GET | ui_server.py | Health check |
-| `/api/memories` | GET | routes/memories.py | List memories |
-| `/api/graph` | GET | routes/memories.py | Knowledge graph data |
-| `/api/search` | POST | routes/memories.py | Semantic search |
-| `/api/clusters` | GET | routes/memories.py | Cluster info |
-| `/api/clusters/{id}` | GET | routes/memories.py | Cluster detail |
-| `/api/stats` | GET | routes/stats.py | System statistics |
-| `/api/timeline` | GET | routes/stats.py | Timeline aggregation |
-| `/api/patterns` | GET | routes/stats.py | Learned patterns |
-| `/api/profiles` | GET | routes/profiles.py | List profiles |
-| `/api/profiles/{n}/switch` | POST | routes/profiles.py | Switch profile |
-| `/api/profiles/create` | POST | routes/profiles.py | Create profile |
-| `/api/profiles/{n}` | DELETE | routes/profiles.py | Delete profile |
-| `/api/export` | GET | routes/data_io.py | Export memories |
-| `/api/import` | POST | routes/data_io.py | Import memories |
-| `/api/backup/*` | GET/POST | routes/backup.py | Backup management |
-| `/events/stream` | GET | routes/events.py | SSE real-time stream |
-| `/api/events` | GET | routes/events.py | Event polling |
-| `/api/events/stats` | GET | routes/events.py | Event statistics |
-| `/api/agents` | GET | routes/agents.py | Agent list |
-| `/api/agents/stats` | GET | routes/agents.py | Agent statistics |
-| `/api/trust/stats` | GET | routes/agents.py | Trust overview |
-| `/api/trust/signals/{id}` | GET | routes/agents.py | Agent trust signals |
-| `/ws/updates` | WS | routes/ws.py | WebSocket |
-
----
-
-*SuperLocalMemory V2.5 — Created by Varun Pratap Bhardwaj. MIT License.*