superlocalmemory 2.8.0 → 2.8.2

package/ui/js/compliance.js

@@ -0,0 +1,252 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+// Compliance tab — audit trail, retention policies, ABAC (v2.8)
+// NOTE: All dynamic values use textContent or escapeHtml() from core.js before DOM insertion.
+
+var _complianceData = null;
+
+async function loadCompliance() {
+    var filterEl = document.getElementById('cp-audit-filter');
+    var filterValue = filterEl ? filterEl.value : '';
+
+    try {
+        var url = '/api/compliance/status';
+        if (filterValue) url += '?event_type=' + encodeURIComponent(filterValue);
+        var response = await fetch(url);
+        var data = await response.json();
+        _complianceData = data;
+
+        if (!data.available) {
+            showEmpty('compliance-audit-content', 'shield-lock', 'Compliance engine not available. Upgrade to v2.8.');
+            return;
+        }
+
+        renderComplianceStats(data);
+        renderCompliancePolicies(data);
+        renderComplianceAudit(data);
+
+        var badge = document.getElementById('compliance-profile-badge');
+        if (badge) badge.textContent = data.active_profile || 'default';
+    } catch (error) {
+        console.error('Error loading compliance:', error);
+    }
+}
+
+function renderComplianceStats(data) {
+    var stats = data.stats || {};
+    animateCounter('cp-audit-count', stats.audit_count || 0);
+    animateCounter('cp-retention-count', stats.retention_count || 0);
+    animateCounter('cp-abac-count', stats.abac_count || 0);
+}
+
+function renderCompliancePolicies(data) {
+    var container = document.getElementById('compliance-policies-content');
+    if (!container) return;
+    var policies = data.retention_policies || [];
+    container.textContent = '';
+
+    if (policies.length === 0) {
+        var empty = document.createElement('div');
+        empty.className = 'text-center text-muted py-3';
+        empty.textContent = 'No retention policies configured. Create one above or use the set_retention_policy MCP tool.';
+        container.appendChild(empty);
+        return;
+    }
+
+    var table = document.createElement('table');
+    table.className = 'table table-sm table-hover mb-0';
+    var thead = document.createElement('thead');
+    var headRow = document.createElement('tr');
+    ['Policy Name', 'Retention (days)', 'Category', 'Action', 'Created'].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 < policies.length; i++) {
+        var pol = policies[i];
+        var row = document.createElement('tr');
+
+        var nameCell = document.createElement('td');
+        var nameIcon = document.createElement('i');
+        nameIcon.className = 'bi bi-shield-check text-success me-1';
+        nameCell.appendChild(nameIcon);
+        nameCell.appendChild(document.createTextNode(pol.name || ''));
+        row.appendChild(nameCell);
+
+        var daysCell = document.createElement('td');
+        daysCell.textContent = (pol.retention_days || 0) + ' days';
+        row.appendChild(daysCell);
+
+        var catCell = document.createElement('td');
+        if (pol.category) {
+            var catBadge = document.createElement('span');
+            catBadge.className = 'badge bg-info';
+            catBadge.textContent = pol.category;
+            catCell.appendChild(catBadge);
+        } else {
+            catCell.textContent = 'All';
+        }
+        row.appendChild(catCell);
+
+        var actionCell = document.createElement('td');
+        var actionColors = { archive: 'bg-secondary', tombstone: 'bg-danger', notify: 'bg-warning' };
+        var actionBadge = document.createElement('span');
+        actionBadge.className = 'badge ' + (actionColors[pol.action] || 'bg-secondary');
+        actionBadge.textContent = pol.action || '';
+        actionCell.appendChild(actionBadge);
+        row.appendChild(actionCell);
+
+        var dateCell = document.createElement('td');
+        dateCell.className = 'small text-muted';
+        dateCell.textContent = formatDate(pol.created_at || '');
+        row.appendChild(dateCell);
+
+        tbody.appendChild(row);
+    }
+    table.appendChild(tbody);
+    container.appendChild(table);
+}
+
+function renderComplianceAudit(data) {
+    var container = document.getElementById('compliance-audit-content');
+    if (!container) return;
+    var events = data.audit_events || [];
+    container.textContent = '';
+
+    if (events.length === 0) {
+        var empty = document.createElement('div');
+        empty.className = 'text-center text-muted py-3';
+        empty.textContent = 'No audit events recorded yet.';
+        container.appendChild(empty);
+        return;
+    }
+
+    var wrapper = document.createElement('div');
+    wrapper.style.maxHeight = '400px';
+    wrapper.style.overflowY = 'auto';
+
+    var table = document.createElement('table');
+    table.className = 'table table-sm table-hover mb-0';
+    var thead = document.createElement('thead');
+    thead.style.position = 'sticky';
+    thead.style.top = '0';
+    thead.style.backgroundColor = 'var(--bs-body-bg)';
+    var headRow = document.createElement('tr');
+    ['Timestamp', 'Event', 'Actor', 'Action', 'Target', 'Result'].forEach(function(h) {
+        var th = document.createElement('th');
+        th.textContent = h;
+        headRow.appendChild(th);
+    });
+    thead.appendChild(headRow);
+    table.appendChild(thead);
+
+    var eventBadgeColors = {
+        recall: 'bg-primary',
+        remember: 'bg-success',
+        delete: 'bg-danger',
+        lifecycle_transition: 'bg-warning',
+        access_denied: 'bg-danger',
+        retention_enforced: 'bg-warning'
+    };
+
+    var tbody = document.createElement('tbody');
+    for (var i = 0; i < events.length; i++) {
+        var ev = events[i];
+        var row = document.createElement('tr');
+
+        var tsCell = document.createElement('td');
+        tsCell.className = 'small text-muted';
+        tsCell.textContent = formatDateFull(ev.timestamp || '');
+        row.appendChild(tsCell);
+
+        var typeCell = document.createElement('td');
+        var typeBadge = document.createElement('span');
+        typeBadge.className = 'badge ' + (eventBadgeColors[ev.event_type] || 'bg-secondary');
+        typeBadge.textContent = ev.event_type || '';
+        typeCell.appendChild(typeBadge);
+        row.appendChild(typeCell);
+
+        var actorCell = document.createElement('td');
+        actorCell.textContent = ev.actor || '';
+        row.appendChild(actorCell);
+
+        var actionCell = document.createElement('td');
+        actionCell.textContent = ev.action || '';
+        row.appendChild(actionCell);
+
+        var targetCell = document.createElement('td');
+        targetCell.className = 'small';
+        targetCell.textContent = ev.target || '';
+        row.appendChild(targetCell);
+
+        var resultCell = document.createElement('td');
+        if (ev.result === 'success' || ev.result === 'allowed') {
+            var okBadge = document.createElement('span');
+            okBadge.className = 'badge bg-success';
+            okBadge.textContent = ev.result;
+            resultCell.appendChild(okBadge);
+        } else if (ev.result === 'denied' || ev.result === 'error') {
+            var failBadge = document.createElement('span');
+            failBadge.className = 'badge bg-danger';
+            failBadge.textContent = ev.result;
+            resultCell.appendChild(failBadge);
+        } else {
+            resultCell.textContent = ev.result || '';
+        }
+        row.appendChild(resultCell);
+
+        tbody.appendChild(row);
+    }
+    table.appendChild(tbody);
+    wrapper.appendChild(table);
+    container.appendChild(wrapper);
+}
+
+async function createRetentionPolicy() {
+    var nameInput = document.getElementById('cp-policy-name');
+    var daysInput = document.getElementById('cp-retention-days');
+    var categoryInput = document.getElementById('cp-category');
+    var actionSelect = document.getElementById('cp-action');
+
+    var policyName = (nameInput.value || '').trim();
+    if (!policyName) {
+        showToast('Enter a policy name.');
+        return;
+    }
+
+    var days = parseInt(daysInput.value, 10);
+    if (isNaN(days) || days <= 0) {
+        showToast('Enter a valid number of days.');
+        return;
+    }
+
+    try {
+        var response = await fetch('/api/compliance/retention-policy', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                name: policyName,
+                retention_days: days,
+                category: categoryInput.value.trim() || undefined,
+                action: actionSelect.value
+            })
+        });
+        var data = await response.json();
+        if (response.ok) {
+            showToast('Retention policy created.');
+            nameInput.value = '';
+            daysInput.value = '90';
+            categoryInput.value = '';
+            loadCompliance(); // Refresh
+        } else {
+            showToast(data.detail || 'Failed to create policy.');
+        }
+    } catch (error) {
+        console.error('Error creating retention policy:', error);
+        showToast('Error creating retention policy.');
+    }
+}

package/ui/js/init.js

@@ -33,3 +33,13 @@ 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);
+
+// v2.8 tabs (graceful — elements may not exist on older installs)
+var lifecycleTab = document.getElementById('lifecycle-tab');
+if (lifecycleTab) lifecycleTab.addEventListener('shown.bs.tab', loadLifecycle);
+
+var behavioralTab = document.getElementById('behavioral-tab');
+if (behavioralTab) behavioralTab.addEventListener('shown.bs.tab', loadBehavioral);
+
+var complianceTab = document.getElementById('compliance-tab');
+if (complianceTab) complianceTab.addEventListener('shown.bs.tab', loadCompliance);

package/ui/js/lifecycle.js

@@ -0,0 +1,298 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+// Lifecycle tab — state distribution, compaction, transitions (v2.8)
+// NOTE: All dynamic values pass through escapeHtml() or textContent for DOM insertion.
+
+var _lifecycleData = null;
+
+async function loadLifecycle() {
+    try {
+        var response = await fetch('/api/lifecycle/status');
+        var data = await response.json();
+        _lifecycleData = data;
+
+        if (!data.available) {
+            showEmpty('lifecycle-states-row', 'hourglass-split', 'Lifecycle engine not available. Upgrade to v2.8.');
+            return;
+        }
+
+        renderLifecycleStates(data);
+        renderLifecycleProgress(data);
+        renderLifecycleAgeStats(data);
+        renderLifecycleTransitions(data);
+
+        var badge = document.getElementById('lifecycle-profile-badge');
+        if (badge) badge.textContent = data.active_profile || 'default';
+    } catch (error) {
+        console.error('Error loading lifecycle:', error);
+    }
+}
+
+function renderLifecycleStates(data) {
+    var states = data.states || {};
+    var mapping = {
+        active: 'lc-active-count',
+        warm: 'lc-warm-count',
+        cold: 'lc-cold-count',
+        archived: 'lc-archived-count',
+        tombstoned: 'lc-tombstoned-count'
+    };
+    for (var state in mapping) {
+        animateCounter(mapping[state], states[state] || 0);
+    }
+    animateCounter('lc-total-count', data.total_memories || 0);
+}
+
+function renderLifecycleProgress(data) {
+    var bar = document.getElementById('lifecycle-progress-bar');
+    if (!bar) return;
+    var states = data.states || {};
+    var total = data.total_memories || 1;
+    var colors = {
+        active: '#198754',
+        warm: '#ffc107',
+        cold: '#0dcaf0',
+        archived: '#6c757d',
+        tombstoned: '#dc3545'
+    };
+
+    bar.textContent = '';
+    var hasSegments = false;
+
+    var stateKeys = ['active', 'warm', 'cold', 'archived', 'tombstoned'];
+    for (var i = 0; i < stateKeys.length; i++) {
+        var state = stateKeys[i];
+        var count = states[state] || 0;
+        if (count > 0) {
+            hasSegments = true;
+            var pct = ((count / total) * 100).toFixed(1);
+            var segment = document.createElement('div');
+            segment.className = 'progress-bar';
+            segment.setAttribute('role', 'progressbar');
+            segment.style.width = pct + '%';
+            segment.style.backgroundColor = colors[state];
+            segment.title = state + ': ' + count + ' (' + pct + '%)';
+            segment.textContent = state;
+            bar.appendChild(segment);
+        }
+    }
+
+    if (!hasSegments) {
+        var fallback = document.createElement('div');
+        fallback.className = 'progress-bar bg-success';
+        fallback.style.width = '100%';
+        fallback.textContent = 'All Active';
+        bar.appendChild(fallback);
+    }
+}
+
+function renderLifecycleAgeStats(data) {
+    var container = document.getElementById('lifecycle-age-content');
+    if (!container) return;
+    var stats = data.age_stats || {};
+    if (Object.keys(stats).length === 0) {
+        container.textContent = '';
+        var empty = document.createElement('span');
+        empty.className = 'text-muted';
+        empty.textContent = 'No age data available yet.';
+        container.appendChild(empty);
+        return;
+    }
+
+    var table = document.createElement('table');
+    table.className = 'table table-sm table-hover mb-0';
+    var thead = document.createElement('thead');
+    var headRow = document.createElement('tr');
+    ['State', 'Avg Age', 'Newest', 'Oldest'].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');
+    var stateOrder = ['active', 'warm', 'cold', 'archived'];
+    var badgeColors = { active: 'success', warm: 'warning', cold: 'info', archived: 'secondary' };
+
+    for (var i = 0; i < stateOrder.length; i++) {
+        var s = stateOrder[i];
+        if (stats[s]) {
+            var row = document.createElement('tr');
+
+            var stateCell = document.createElement('td');
+            var stateBadge = document.createElement('span');
+            stateBadge.className = 'badge bg-' + (badgeColors[s] || 'secondary');
+            stateBadge.textContent = s;
+            stateCell.appendChild(stateBadge);
+            row.appendChild(stateCell);
+
+            var avgCell = document.createElement('td');
+            avgCell.textContent = (stats[s].avg_days || 0) + 'd';
+            row.appendChild(avgCell);
+
+            var minCell = document.createElement('td');
+            minCell.textContent = (stats[s].min_days || 0) + 'd';
+            row.appendChild(minCell);
+
+            var maxCell = document.createElement('td');
+            maxCell.textContent = (stats[s].max_days || 0) + 'd';
+            row.appendChild(maxCell);
+
+            tbody.appendChild(row);
+        }
+    }
+    table.appendChild(tbody);
+
+    container.textContent = '';
+    container.appendChild(table);
+}
+
+function renderLifecycleTransitions(data) {
+    var container = document.getElementById('lifecycle-transitions-content');
+    if (!container) return;
+    var transitions = data.recent_transitions || [];
+    if (transitions.length === 0) {
+        container.textContent = '';
+        var empty = document.createElement('span');
+        empty.className = 'text-muted';
+        empty.textContent = 'No transitions yet. Memories start as Active and transition based on usage.';
+        container.appendChild(empty);
+        return;
+    }
+
+    var table = document.createElement('table');
+    table.className = 'table table-sm table-hover mb-0';
+    var thead = document.createElement('thead');
+    var headRow = document.createElement('tr');
+    ['Memory', 'State', 'Last Transition'].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 < transitions.length; i++) {
+        var t = transitions[i];
+        var row = document.createElement('tr');
+
+        var memCell = document.createElement('td');
+        var preview = (t.content_preview || '').substring(0, 40);
+        memCell.textContent = '#' + t.memory_id + ' ' + preview + (preview.length >= 40 ? '...' : '');
+        memCell.title = t.content_preview || '';
+        row.appendChild(memCell);
+
+        var stateCell = document.createElement('td');
+        var badge = document.createElement('span');
+        badge.className = 'badge bg-secondary';
+        badge.textContent = t.current_state || '';
+        stateCell.appendChild(badge);
+        row.appendChild(stateCell);
+
+        var transCell = document.createElement('td');
+        transCell.className = 'small text-muted';
+        transCell.textContent = JSON.stringify(t.last_transition || {});
+        row.appendChild(transCell);
+
+        tbody.appendChild(row);
+    }
+    table.appendChild(tbody);
+
+    container.textContent = '';
+    container.appendChild(table);
+}
+
+async function compactDryRun() {
+    try {
+        var response = await fetch('/api/lifecycle/compact', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ dry_run: true })
+        });
+        var data = await response.json();
+        var resultsDiv = document.getElementById('compaction-results');
+        var titleEl = document.getElementById('compaction-results-title');
+        var contentEl = document.getElementById('compaction-results-content');
+        resultsDiv.classList.remove('d-none');
+        titleEl.textContent = 'Compaction Preview (Dry Run)';
+        contentEl.textContent = '';
+
+        if (data.recommendations === 0) {
+            var ok = document.createElement('span');
+            ok.className = 'text-success';
+            var icon = document.createElement('i');
+            icon.className = 'bi bi-check-circle';
+            ok.appendChild(icon);
+            ok.appendChild(document.createTextNode(' No compaction needed. All memories are in optimal states.'));
+            contentEl.appendChild(ok);
+        } else {
+            var p = document.createElement('p');
+            p.className = 'mb-2';
+            p.textContent = data.recommendations + ' memories would be transitioned:';
+            contentEl.appendChild(p);
+
+            var table = document.createElement('table');
+            table.className = 'table table-sm mb-0';
+            var thead = document.createElement('thead');
+            var headRow = document.createElement('tr');
+            ['Memory ID', 'From', 'To'].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');
+            var details = data.details || [];
+            for (var i = 0; i < details.length; i++) {
+                var row = document.createElement('tr');
+                var idCell = document.createElement('td');
+                idCell.textContent = '#' + details[i].memory_id;
+                row.appendChild(idCell);
+                var fromCell = document.createElement('td');
+                fromCell.textContent = details[i].from || '';
+                row.appendChild(fromCell);
+                var toCell = document.createElement('td');
+                toCell.textContent = details[i].to || '';
+                row.appendChild(toCell);
+                tbody.appendChild(row);
+            }
+            table.appendChild(tbody);
+            contentEl.appendChild(table);
+        }
+    } catch (e) {
+        console.error('Compaction preview error:', e);
+    }
+}
+
+async function compactExecute() {
+    if (!confirm('This will transition memories to lower lifecycle states. Continue?')) return;
+    try {
+        var response = await fetch('/api/lifecycle/compact', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ dry_run: false })
+        });
+        var data = await response.json();
+        var resultsDiv = document.getElementById('compaction-results');
+        var contentEl = document.getElementById('compaction-results-content');
+        resultsDiv.classList.remove('d-none');
+        document.getElementById('compaction-results-title').textContent = 'Compaction Results';
+
+        contentEl.textContent = '';
+        var ok = document.createElement('span');
+        ok.className = 'text-success';
+        var icon = document.createElement('i');
+        icon.className = 'bi bi-check-circle';
+        ok.appendChild(icon);
+        ok.appendChild(document.createTextNode(' ' + (data.transitioned || 0) + ' memories transitioned successfully.'));
+        contentEl.appendChild(ok);
+
+        loadLifecycle(); // Refresh
+    } catch (e) {
+        console.error('Compaction error:', e);
+    }
+}

package/ui/js/profiles.js

@@ -220,6 +220,10 @@ async function switchProfile(profileName) {
             if (typeof loadMemories === 'function') loadMemories();
             if (typeof loadTimeline === 'function') loadTimeline();
             if (typeof loadEvents === 'function') loadEvents();
+            // v2.8 tabs
+            if (typeof loadLifecycle === 'function') loadLifecycle();
+            if (typeof loadBehavioral === 'function') loadBehavioral();
+            if (typeof loadCompliance === 'function') loadCompliance();
             var activeTab = document.querySelector('#mainTabs .nav-link.active');
             if (activeTab) activeTab.click();
         } else {

package/ui_server.py

@@ -148,6 +148,25 @@ app.include_router(ws_router)
 if LEARNING_ROUTES:
     app.include_router(learning_router)
 
+# v2.8 routes (graceful — don't fail if engines unavailable)
+try:
+    from routes.lifecycle import router as lifecycle_router
+    app.include_router(lifecycle_router)
+except ImportError:
+    pass
+
+try:
+    from routes.behavioral import router as behavioral_router
+    app.include_router(behavioral_router)
+except ImportError:
+    pass
+
+try:
+    from routes.compliance import router as compliance_router
+    app.include_router(compliance_router)
+except ImportError:
+    pass
+
 # Wire WebSocket manager into routes that need broadcast capability
 import routes.profiles as _profiles_mod
 import routes.data_io as _data_io_mod