superlocalmemory 2.7.0 → 2.7.2

package/CHANGELOG.md

@@ -16,6 +16,15 @@ SuperLocalMemory V2 - Intelligent local memory system for AI coding assistants.
 
 ---
 
+## [2.7.1] - 2026-02-16
+
+### Added
+- **Learning Dashboard Tab** — New "Learning" tab in the web dashboard showing ranking phase, tech preferences, workflow patterns, source quality, engagement health, and privacy controls
+- **Learning API Routes** — `/api/learning/status`, `/api/learning/reset`, `/api/learning/retrain` endpoints for the dashboard
+- **One-click Reset** — Reset all learning data directly from the dashboard UI
+
+---
+
 ## [2.7.0] - 2026-02-16
 
 **Release Type:** Major Feature Release — "Your AI Learns You"

package/install.sh

@@ -187,6 +187,32 @@ if [ -f "${REPO_DIR}/api_server.py" ]; then
     echo "✓ API server copied"
 fi
 
+# Copy UI server + dashboard files
+if [ -f "${REPO_DIR}/ui_server.py" ]; then
+    cp "${REPO_DIR}/ui_server.py" "${INSTALL_DIR}/"
+    echo "✓ UI server copied"
+fi
+
+if [ -d "${REPO_DIR}/ui" ]; then
+    mkdir -p "${INSTALL_DIR}/ui/js"
+    cp "${REPO_DIR}/ui/index.html" "${INSTALL_DIR}/ui/" 2>/dev/null || true
+    cp "${REPO_DIR}/ui/js/"*.js "${INSTALL_DIR}/ui/js/" 2>/dev/null || true
+    echo "✓ Dashboard UI copied"
+fi
+
+# Copy route modules (v2.5+ dashboard API)
+if [ -d "${REPO_DIR}/routes" ]; then
+    mkdir -p "${INSTALL_DIR}/routes"
+    cp "${REPO_DIR}/routes/"*.py "${INSTALL_DIR}/routes/"
+    echo "✓ Dashboard routes copied"
+fi
+
+# Copy MCP server
+if [ -f "${REPO_DIR}/mcp_server.py" ]; then
+    cp "${REPO_DIR}/mcp_server.py" "${INSTALL_DIR}/"
+    echo "✓ MCP server copied"
+fi
+
 # Copy config if not exists
 if [ ! -f "${INSTALL_DIR}/config.json" ]; then
     echo "Creating default config..."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "description": "Your AI Finally Remembers You - Local-first intelligent memory system for AI assistants. Works with Claude, Cursor, Windsurf, VS Code/Copilot, Codex, and 17+ AI tools. 100% local, zero cloud dependencies.",
   "keywords": [
     "ai-memory",

package/src/learning/feedback_collector.py

@@ -122,9 +122,16 @@ class FeedbackCollector:
         """
         Args:
             learning_db: LearningDB instance for persisting feedback.
-                         If None, feedback is logged but not stored.
+                         If None, auto-creates a LearningDB instance.
         """
-        self.learning_db = learning_db
+        if learning_db is None:
+            try:
+                from .learning_db import LearningDB
+                self.learning_db = LearningDB()
+            except Exception:
+                self.learning_db = None
+        else:
+            self.learning_db = learning_db
 
         # In-memory buffer for passive decay tracking.
         # Structure: {query_hash: {memory_id: times_returned_count}}

package/ui/index.html

@@ -720,6 +720,11 @@
                     <i class="bi bi-clock-history"></i> Timeline
                 </button>
             </li>
+            <li class="nav-item">
+                <button class="nav-link" id="learning-tab" data-bs-toggle="tab" data-bs-target="#learning-pane">
+                    <i class="bi bi-mortarboard"></i> Learning <span class="badge bg-warning text-dark" style="font-size:0.6rem;vertical-align:top;">v2.7</span>
+                </button>
+            </li>
             <li class="nav-item">
                 <button class="nav-link" id="events-tab" data-bs-toggle="tab" data-bs-target="#events-pane">
                     <i class="bi bi-broadcast"></i> Live Events
@@ -906,6 +911,144 @@
                 </div>
             </div>
 
+            <!-- Learning System (v2.7) -->
+            <div class="tab-pane fade" id="learning-pane">
+                <!-- Ranking Phase & Engagement -->
+                <div class="row g-3 mb-3">
+                    <div class="col-md-4">
+                        <div class="card p-3 text-center">
+                            <div class="fw-bold text-muted small">RANKING PHASE</div>
+                            <div class="fs-3 fw-bold" id="learning-phase" style="color: var(--bs-primary);">--</div>
+                            <small class="text-muted" id="learning-phase-detail">Loading...</small>
+                        </div>
+                    </div>
+                    <div class="col-md-4">
+                        <div class="card p-3 text-center">
+                            <div class="fw-bold text-muted small">FEEDBACK SIGNALS</div>
+                            <div class="fs-3 fw-bold" id="learning-feedback-count">0</div>
+                            <small class="text-muted" id="learning-feedback-detail">0 unique queries</small>
+                        </div>
+                    </div>
+                    <div class="col-md-4">
+                        <div class="card p-3 text-center">
+                            <div class="fw-bold text-muted small">ENGAGEMENT HEALTH</div>
+                            <div class="fs-3 fw-bold" id="learning-health" style="color: var(--bs-success);">--</div>
+                            <small class="text-muted" id="learning-health-detail">Loading...</small>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Phase Progress Bar -->
+                <div class="card p-3 mb-3">
+                    <h6 class="mb-2"><i class="bi bi-bar-chart-steps"></i> Adaptive Ranking Progress</h6>
+                    <div class="d-flex align-items-center gap-2 mb-2">
+                        <div class="flex-grow-1">
+                            <div class="progress" style="height: 24px; border-radius: 12px;">
+                                <div class="progress-bar" id="learning-progress" role="progressbar" style="width: 0%; border-radius: 12px; transition: width 0.8s ease;" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="d-flex justify-content-between small text-muted">
+                        <span>Baseline (0)</span>
+                        <span>Rule-Based (20+)</span>
+                        <span>ML Model (200+)</span>
+                    </div>
+                </div>
+
+                <div class="row g-3">
+                    <!-- Tech Preferences (Layer 1) -->
+                    <div class="col-md-6">
+                        <div class="card p-3 h-100">
+                            <div class="d-flex justify-content-between align-items-center mb-3">
+                                <h6 class="mb-0"><i class="bi bi-cpu"></i> Tech Preferences</h6>
+                                <span class="badge bg-primary">Layer 1</span>
+                            </div>
+                            <div id="learning-tech-prefs">
+                                <div class="text-center text-muted py-3">
+                                    <i class="bi bi-hourglass-split" style="font-size: 1.5rem;"></i>
+                                    <p class="mt-2 mb-0 small">Patterns detected after using recall with feedback</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Workflow Patterns (Layer 3) -->
+                    <div class="col-md-6">
+                        <div class="card p-3 h-100">
+                            <div class="d-flex justify-content-between align-items-center mb-3">
+                                <h6 class="mb-0"><i class="bi bi-diagram-3"></i> Workflow Patterns</h6>
+                                <span class="badge bg-info">Layer 3</span>
+                            </div>
+                            <div id="learning-workflows">
+                                <div class="text-center text-muted py-3">
+                                    <i class="bi bi-hourglass-split" style="font-size: 1.5rem;"></i>
+                                    <p class="mt-2 mb-0 small">Sequences detected after 30+ memories</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="row g-3 mt-0">
+                    <!-- Source Quality -->
+                    <div class="col-md-6">
+                        <div class="card p-3 h-100">
+                            <div class="d-flex justify-content-between align-items-center mb-3">
+                                <h6 class="mb-0"><i class="bi bi-stars"></i> Source Quality</h6>
+                                <span class="badge bg-success">Per-Tool Scoring</span>
+                            </div>
+                            <div id="learning-sources">
+                                <div class="text-center text-muted py-3">
+                                    <i class="bi bi-hourglass-split" style="font-size: 1.5rem;"></i>
+                                    <p class="mt-2 mb-0 small">Quality scores computed after feedback signals</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Engagement & Privacy -->
+                    <div class="col-md-6">
+                        <div class="card p-3 h-100">
+                            <div class="d-flex justify-content-between align-items-center mb-3">
+                                <h6 class="mb-0"><i class="bi bi-shield-lock"></i> Privacy & Data</h6>
+                                <span class="badge bg-secondary">GDPR Compliant</span>
+                            </div>
+                            <div id="learning-privacy">
+                                <div class="small">
+                                    <div class="d-flex justify-content-between border-bottom py-1">
+                                        <span class="text-muted">Learning DB</span>
+                                        <span class="fw-bold" id="learning-db-size">--</span>
+                                    </div>
+                                    <div class="d-flex justify-content-between border-bottom py-1">
+                                        <span class="text-muted">Patterns learned</span>
+                                        <span class="fw-bold" id="learning-pattern-count">0</span>
+                                    </div>
+                                    <div class="d-flex justify-content-between border-bottom py-1">
+                                        <span class="text-muted">Models trained</span>
+                                        <span class="fw-bold" id="learning-model-count">0</span>
+                                    </div>
+                                    <div class="d-flex justify-content-between border-bottom py-1">
+                                        <span class="text-muted">Sources tracked</span>
+                                        <span class="fw-bold" id="learning-source-count">0</span>
+                                    </div>
+                                    <div class="d-flex justify-content-between py-1">
+                                        <span class="text-muted">Telemetry</span>
+                                        <span class="text-success fw-bold">None</span>
+                                    </div>
+                                </div>
+                                <div class="mt-2">
+                                    <button class="btn btn-sm btn-outline-danger" onclick="resetLearning()">
+                                        <i class="bi bi-trash"></i> Reset Learning Data
+                                    </button>
+                                    <small class="text-muted d-block mt-1">Deletes learning.db. Memories preserved.</small>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
             <!-- Live Events (v2.5) -->
             <div class="tab-pane fade" id="events-pane">
                 <div class="card p-3 mb-3">
@@ -1175,6 +1318,7 @@
     <script src="static/js/settings.js"></script>
     <script src="static/js/events.js"></script>
     <script src="static/js/agents.js"></script>
+    <script src="static/js/learning.js"></script>
     <script src="static/js/init.js"></script>
 
     <footer>

package/ui/js/init.js

@@ -29,3 +29,7 @@ if (eventsTab) eventsTab.addEventListener('shown.bs.tab', loadEventStats);
 
 var agentsTab = document.getElementById('agents-tab');
 if (agentsTab) agentsTab.addEventListener('shown.bs.tab', loadAgents);
+
+// v2.7 learning tab (graceful)
+var learningTab = document.getElementById('learning-tab');
+if (learningTab) learningTab.addEventListener('shown.bs.tab', loadLearning);

package/ui/js/learning.js

@@ -0,0 +1,318 @@
+// SuperLocalMemory V2 - Learning System Dashboard (v2.7)
+// Copyright (c) 2026 Varun Pratap Bhardwaj - MIT License
+// NOTE: All dynamic values pass through escapeHtml() from core.js before DOM insertion.
+
+var _learningData = null;
+
+async function loadLearning() {
+    try {
+        var response = await fetch('/api/learning/status');
+        var data = await response.json();
+        _learningData = data;
+        renderLearningStatus(data);
+    } catch (error) {
+        console.error('Error loading learning status:', error);
+        var el = document.getElementById('learning-phase');
+        if (el) el.textContent = 'Unavailable';
+        var detail = document.getElementById('learning-phase-detail');
+        if (detail) detail.textContent = 'Learning system not available';
+    }
+}
+
+function renderLearningStatus(data) {
+    renderPhase(data);
+    renderFeedbackCount(data.stats);
+    renderEngagementHealth(data.engagement);
+    renderProgressBar(data.stats ? data.stats.feedback_count : 0);
+    renderTechPreferences(data.tech_preferences || []);
+    renderWorkflowPatterns(data.workflow_patterns || []);
+    renderSourceQuality(data.source_scores || {});
+    renderPrivacyStats(data.stats);
+}
+
+function renderPhase(data) {
+    var phaseEl = document.getElementById('learning-phase');
+    var phaseDetail = document.getElementById('learning-phase-detail');
+    if (!phaseEl) return;
+
+    if (!data.ranking_phase) {
+        phaseEl.textContent = 'Not Available';
+        phaseEl.style.color = 'var(--bs-secondary)';
+        if (phaseDetail) phaseDetail.textContent = 'Install: pip3 install lightgbm scipy';
+        return;
+    }
+
+    var labels = { 'baseline': 'Baseline', 'rule_based': 'Rule-Based', 'ml_model': 'ML Model' };
+    var colors = { 'baseline': 'var(--bs-secondary)', 'rule_based': 'var(--bs-primary)', 'ml_model': 'var(--bs-warning)' };
+    phaseEl.textContent = labels[data.ranking_phase] || data.ranking_phase;
+    phaseEl.style.color = colors[data.ranking_phase] || 'var(--bs-primary)';
+
+    var fc = (data.stats && data.stats.feedback_count) || 0;
+    if (phaseDetail) {
+        if (data.ranking_phase === 'baseline') phaseDetail.textContent = 'Need 20+ signals. Currently: ' + fc;
+        else if (data.ranking_phase === 'rule_based') phaseDetail.textContent = 'Active! Need 200+ for ML. Currently: ' + fc;
+        else phaseDetail.textContent = 'Full ML ranking with ' + fc + ' signals';
+    }
+}
+
+function renderFeedbackCount(stats) {
+    var el = document.getElementById('learning-feedback-count');
+    var detail = document.getElementById('learning-feedback-detail');
+    if (el && stats) el.textContent = stats.feedback_count || 0;
+    if (detail && stats) detail.textContent = (stats.unique_queries || 0) + ' unique queries';
+}
+
+function renderEngagementHealth(engagement) {
+    var el = document.getElementById('learning-health');
+    var detail = document.getElementById('learning-health-detail');
+    if (!el) return;
+    if (!engagement) { el.textContent = '--'; return; }
+
+    var status = engagement.health_status || 'UNKNOWN';
+    var colors = { 'HEALTHY': 'var(--bs-success)', 'DECLINING': 'var(--bs-warning)', 'AT_RISK': 'var(--bs-danger)', 'INACTIVE': 'var(--bs-secondary)' };
+    el.textContent = status;
+    el.style.color = colors[status] || 'var(--bs-secondary)';
+    if (detail) {
+        var p = [];
+        if (engagement.days_active !== undefined) p.push(engagement.days_active + ' days active');
+        if (engagement.memories_per_day !== undefined) p.push(engagement.memories_per_day.toFixed(1) + ' mem/day');
+        detail.textContent = p.join(' | ') || 'No data';
+    }
+}
+
+function renderProgressBar(count) {
+    var bar = document.getElementById('learning-progress');
+    if (!bar) return;
+    var pct = 0, cls = 'bg-secondary', lbl = '';
+
+    if (count >= 200) { pct = 100; cls = 'bg-warning'; lbl = 'ML Model Active'; }
+    else if (count >= 20) { pct = 10 + ((count - 20) / 180) * 60; cls = 'bg-primary'; lbl = 'Rule-Based (' + count + '/200)'; }
+    else if (count > 0) { pct = (count / 20) * 10; lbl = 'Baseline (' + count + '/20)'; }
+    else { lbl = 'No feedback yet'; }
+
+    bar.style.width = Math.min(pct, 100) + '%';
+    bar.className = 'progress-bar ' + cls;
+    bar.textContent = lbl;
+}
+
+function renderTechPreferences(patterns) {
+    var container = document.getElementById('learning-tech-prefs');
+    if (!container) return;
+    container.textContent = '';
+
+    if (!patterns || patterns.length === 0) {
+        var empty = document.createElement('div');
+        empty.className = 'text-center text-muted py-3';
+        empty.textContent = 'No patterns yet. Use recall + feedback to start learning.';
+        container.appendChild(empty);
+        return;
+    }
+
+    for (var i = 0; i < patterns.length; i++) {
+        var p = patterns[i];
+        var confPct = Math.round((p.confidence || 0) * 100);
+        var barColor = confPct >= 80 ? 'bg-success' : (confPct >= 60 ? 'bg-primary' : 'bg-secondary');
+
+        var row = document.createElement('div');
+        row.className = 'd-flex align-items-center mb-2';
+
+        var label = document.createElement('div');
+        label.style.minWidth = '120px';
+        var labelSpan = document.createElement('span');
+        labelSpan.className = 'text-muted small';
+        labelSpan.textContent = p.key || '';
+        label.appendChild(labelSpan);
+
+        var barWrap = document.createElement('div');
+        barWrap.className = 'flex-grow-1 mx-2';
+        var progress = document.createElement('div');
+        progress.className = 'progress';
+        progress.style.height = '18px';
+        progress.style.borderRadius = '9px';
+        var barEl = document.createElement('div');
+        barEl.className = 'progress-bar ' + barColor;
+        barEl.style.width = confPct + '%';
+        barEl.style.borderRadius = '9px';
+        barEl.style.fontSize = '0.7rem';
+        barEl.textContent = (p.value || '') + ' (' + confPct + '%)';
+        progress.appendChild(barEl);
+        barWrap.appendChild(progress);
+
+        var evidence = document.createElement('small');
+        evidence.className = 'text-muted';
+        evidence.style.minWidth = '60px';
+        evidence.style.textAlign = 'right';
+        evidence.textContent = (p.evidence || 0) + ' ev.';
+
+        row.appendChild(label);
+        row.appendChild(barWrap);
+        row.appendChild(evidence);
+        container.appendChild(row);
+    }
+}
+
+function renderWorkflowPatterns(workflows) {
+    var container = document.getElementById('learning-workflows');
+    if (!container) return;
+    container.textContent = '';
+
+    if (!workflows || workflows.length === 0) {
+        var empty = document.createElement('div');
+        empty.className = 'text-center text-muted py-3';
+        empty.textContent = 'Sequences detected after 30+ memories.';
+        container.appendChild(empty);
+        return;
+    }
+
+    for (var i = 0; i < workflows.length; i++) {
+        var w = workflows[i];
+        var card = document.createElement('div');
+        card.className = 'mb-2 p-2 border rounded';
+
+        if (w.type === 'sequence') {
+            var seq = [];
+            try { seq = JSON.parse(w.value); } catch(e) { seq = [String(w.value)]; }
+            var flowDiv = document.createElement('div');
+            flowDiv.className = 'd-flex align-items-center flex-wrap gap-1';
+            for (var j = 0; j < seq.length; j++) {
+                if (j > 0) {
+                    var arrow = document.createElement('i');
+                    arrow.className = 'bi bi-arrow-right text-muted small';
+                    flowDiv.appendChild(arrow);
+                }
+                var badge = document.createElement('span');
+                badge.className = 'badge bg-primary bg-opacity-75';
+                badge.textContent = seq[j];
+                flowDiv.appendChild(badge);
+            }
+            card.appendChild(flowDiv);
+        } else if (w.type === 'temporal') {
+            // Parse temporal pattern: show "Morning: code (26%)" format
+            var parsed = {};
+            try { parsed = JSON.parse(w.value); } catch(e) { parsed = {}; }
+            var timeBadge = document.createElement('span');
+            timeBadge.className = 'badge bg-info bg-opacity-75 me-2';
+            timeBadge.textContent = (w.key || '').charAt(0).toUpperCase() + (w.key || '').slice(1);
+            card.appendChild(timeBadge);
+
+            var activity = document.createElement('span');
+            activity.className = 'fw-bold';
+            activity.textContent = parsed.dominant_activity || w.value;
+            card.appendChild(activity);
+
+            var evCount = document.createElement('small');
+            evCount.className = 'text-muted ms-2';
+            evCount.textContent = '(' + (parsed.evidence_count || 0) + ' memories)';
+            card.appendChild(evCount);
+
+            // Show distribution as mini bar
+            if (parsed.distribution) {
+                var distDiv = document.createElement('div');
+                distDiv.className = 'd-flex flex-wrap gap-1 mt-1';
+                var sortedActivities = Object.entries(parsed.distribution).sort(function(a, b) { return b[1] - a[1]; });
+                var total = sortedActivities.reduce(function(s, e) { return s + e[1]; }, 0);
+                for (var k = 0; k < sortedActivities.length; k++) {
+                    var actName = sortedActivities[k][0];
+                    var actCount = sortedActivities[k][1];
+                    var actPct = Math.round((actCount / total) * 100);
+                    var actBadge = document.createElement('span');
+                    actBadge.className = 'badge bg-light text-dark';
+                    actBadge.style.fontSize = '0.65rem';
+                    actBadge.textContent = actName + ' ' + actPct + '%';
+                    distDiv.appendChild(actBadge);
+                }
+                card.appendChild(distDiv);
+            }
+        } else {
+            var typeBadge = document.createElement('span');
+            typeBadge.className = 'badge bg-info bg-opacity-75';
+            typeBadge.textContent = w.key || w.type;
+            card.appendChild(typeBadge);
+            var valSpan = document.createElement('span');
+            valSpan.className = 'small ms-1';
+            valSpan.textContent = w.value || '';
+            card.appendChild(valSpan);
+        }
+
+        var confSmall = document.createElement('small');
+        confSmall.className = 'text-muted d-block';
+        confSmall.textContent = 'Confidence: ' + Math.round((w.confidence || 0) * 100) + '%';
+        card.appendChild(confSmall);
+        container.appendChild(card);
+    }
+}
+
+function renderSourceQuality(scores) {
+    var container = document.getElementById('learning-sources');
+    if (!container) return;
+    container.textContent = '';
+
+    var sources = Object.keys(scores);
+    if (sources.length === 0) {
+        var empty = document.createElement('div');
+        empty.className = 'text-center text-muted py-3';
+        empty.textContent = 'Source quality computed after feedback signals.';
+        container.appendChild(empty);
+        return;
+    }
+
+    sources.sort(function(a, b) { return scores[b] - scores[a]; });
+
+    for (var i = 0; i < sources.length; i++) {
+        var src = sources[i];
+        var pct = Math.round(scores[src] * 100);
+        var barColor = pct >= 60 ? 'bg-success' : (pct >= 40 ? 'bg-warning' : 'bg-danger');
+
+        var row = document.createElement('div');
+        row.className = 'd-flex align-items-center mb-2';
+
+        var label = document.createElement('div');
+        label.style.minWidth = '140px';
+        var code = document.createElement('code');
+        code.className = 'small';
+        code.textContent = src;
+        label.appendChild(code);
+
+        var barWrap = document.createElement('div');
+        barWrap.className = 'flex-grow-1 mx-2';
+        var progress = document.createElement('div');
+        progress.className = 'progress';
+        progress.style.height = '16px';
+        progress.style.borderRadius = '8px';
+        var barEl = document.createElement('div');
+        barEl.className = 'progress-bar ' + barColor;
+        barEl.style.width = pct + '%';
+        barEl.style.borderRadius = '8px';
+        barEl.style.fontSize = '0.65rem';
+        barEl.textContent = pct + '%';
+        progress.appendChild(barEl);
+        barWrap.appendChild(progress);
+
+        row.appendChild(label);
+        row.appendChild(barWrap);
+        container.appendChild(row);
+    }
+}
+
+function renderPrivacyStats(stats) {
+    if (!stats) return;
+    var el;
+    el = document.getElementById('learning-db-size');
+    if (el) el.textContent = (stats.db_size_kb || 0) + ' KB';
+    el = document.getElementById('learning-pattern-count');
+    if (el) el.textContent = stats.transferable_patterns || 0;
+    el = document.getElementById('learning-model-count');
+    if (el) el.textContent = stats.models_trained || 0;
+    el = document.getElementById('learning-source-count');
+    if (el) el.textContent = stats.tracked_sources || 0;
+}
+
+async function resetLearning() {
+    if (!confirm('Delete all learning data? Memories will be preserved.')) return;
+    try {
+        var response = await fetch('/api/learning/reset', { method: 'POST' });
+        var data = await response.json();
+        if (data.success) { alert('Learning data reset. Memories preserved.'); loadLearning(); }
+        else alert('Reset failed: ' + (data.error || 'Unknown error'));
+    } catch (error) { alert('Reset failed: ' + error.message); }
+}

package/ui_server.py

@@ -142,6 +142,13 @@ from routes.events import router as events_router, register_event_listener
 from routes.agents import router as agents_router
 from routes.ws import router as ws_router, manager as ws_manager
 
+# v2.7 Learning routes (graceful)
+try:
+    from routes.learning import router as learning_router
+    LEARNING_ROUTES = True
+except ImportError:
+    LEARNING_ROUTES = False
+
 app.include_router(memories_router)
 app.include_router(stats_router)
 app.include_router(profiles_router)
@@ -150,6 +157,8 @@ app.include_router(data_io_router)
 app.include_router(events_router)
 app.include_router(agents_router)
 app.include_router(ws_router)
+if LEARNING_ROUTES:
+    app.include_router(learning_router)
 
 # Wire WebSocket manager into routes that need broadcast capability
 import routes.profiles as _profiles_mod