superlocalmemory 2.6.0 → 2.7.0

package/bin/slm

@@ -121,13 +121,178 @@ case "$1" in
             context)
                 python3 "$SLM_DIR/pattern_learner.py" context "$@"
                 ;;
+            correct)
+                # slm patterns correct <id> <new_value>
+                pattern_id="$1"
+                new_value="$2"
+                if [ -z "$pattern_id" ] || [ -z "$new_value" ]; then
+                    echo "Usage: slm patterns correct <pattern_id> <new_value>"
+                    exit 1
+                fi
+                python3 -c "
+import sys
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname "${SLM_DIR}")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning import get_learning_db
+    ldb = get_learning_db()
+    if ldb:
+        conn = ldb._get_connection()
+        cursor = conn.cursor()
+        cursor.execute('SELECT * FROM transferable_patterns WHERE id = ?', (int(sys.argv[1]),))
+        p = cursor.fetchone()
+        conn.close()
+        if p:
+            ldb.upsert_transferable_pattern(
+                pattern_type=p['pattern_type'], key=p['key'],
+                value=sys.argv[2], confidence=1.0,
+                evidence_count=p['evidence_count']+1,
+                profiles_seen=p['profiles_seen'],
+                contradictions=[f\"Corrected from '{p['value']}' to '{sys.argv[2]}'\"],
+            )
+            print(f\"Pattern '{p['key']}' corrected: '{p['value']}' -> '{sys.argv[2]}'\")
+        else:
+            print(f'Pattern #{sys.argv[1]} not found')
+    else:
+        print('Learning database not available')
+except ImportError:
+    print('Learning features not available')
+except Exception as e:
+    print(f'Error: {e}')
+" "$pattern_id" "$new_value"
+                ;;
             *)
-                echo "Usage: slm patterns {update|list|context}"
+                echo "Usage: slm patterns {update|list|context|correct}"
                 exit 1
                 ;;
         esac
         ;;
 
+    useful)
+        shift
+        # Mark memory IDs as useful (v2.7 learning feedback)
+        if [ -z "$1" ]; then
+            echo "Usage: slm useful <memory_id> [memory_id...]"
+            echo "  Mark recalled memories as useful to improve future ranking"
+            exit 1
+        fi
+        python3 -c "
+import sys
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning.feedback_collector import FeedbackCollector
+    fc = FeedbackCollector()
+    ids = [int(x) for x in sys.argv[1:]]
+    fc.record_cli_useful(ids, query='cli-feedback')
+    print(f'Marked {len(ids)} memor{\"y\" if len(ids)==1 else \"ies\"} as useful')
+except ImportError:
+    print('Learning features not available. Install: pip3 install lightgbm scipy')
+except Exception as e:
+    print(f'Error: {e}')
+" "$@"
+        ;;
+
+    learning)
+        shift
+        subcommand="${1:-status}"
+        shift 2>/dev/null || true
+        case "$subcommand" in
+            status)
+                python3 -c "
+import sys, json
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning import get_status
+    status = get_status()
+    print('SuperLocalMemory v2.7 — Learning System Status')
+    print('=' * 50)
+    deps = status['dependencies']
+    print(f'LightGBM:  {\"installed (\" + deps[\"lightgbm\"][\"version\"] + \")\" if deps[\"lightgbm\"][\"installed\"] else \"not installed\"}')
+    print(f'SciPy:     {\"installed (\" + deps[\"scipy\"][\"version\"] + \")\" if deps[\"scipy\"][\"installed\"] else \"not installed\"}')
+    print(f'ML Ranking:  {\"available\" if status[\"ml_ranking_available\"] else \"unavailable\"}')
+    print(f'Full Learning: {\"available\" if status[\"learning_available\"] else \"unavailable\"}')
+    if status.get('learning_db_stats'):
+        s = status['learning_db_stats']
+        print(f'')
+        print(f'Feedback signals: {s[\"feedback_count\"]}')
+        print(f'Unique queries:   {s[\"unique_queries\"]}')
+        print(f'Patterns learned: {s[\"transferable_patterns\"]} ({s[\"high_confidence_patterns\"]} high confidence)')
+        print(f'Workflow patterns: {s[\"workflow_patterns\"]}')
+        print(f'Sources tracked:  {s[\"tracked_sources\"]}')
+        print(f'Models trained:   {s[\"models_trained\"]}')
+        print(f'Learning DB size: {s[\"db_size_kb\"]} KB')
+except ImportError:
+    print('Learning features not available. Install: pip3 install lightgbm scipy')
+except Exception as e:
+    print(f'Error: {e}')
+"
+                ;;
+            retrain)
+                python3 -c "
+import sys
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning import get_adaptive_ranker
+    ranker = get_adaptive_ranker()
+    if ranker:
+        result = ranker.train(force=True)
+        if result:
+            print(f'Model retrained successfully')
+        else:
+            print('Insufficient data for training (need 200+ feedback signals)')
+    else:
+        print('Adaptive ranker not available')
+except ImportError:
+    print('Learning features not available. Install: pip3 install lightgbm scipy')
+except Exception as e:
+    print(f'Error: {e}')
+"
+                ;;
+            reset)
+                python3 -c "
+import sys
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning import get_learning_db
+    ldb = get_learning_db()
+    if ldb:
+        ldb.reset()
+        print('All learning data reset. Memories in memory.db preserved.')
+    else:
+        print('Learning database not available')
+except ImportError:
+    print('Learning features not available')
+except Exception as e:
+    print(f'Error: {e}')
+"
+                ;;
+            *)
+                echo "Usage: slm learning {status|retrain|reset}"
+                exit 1
+                ;;
+        esac
+        ;;
+
+    engagement)
+        python3 -c "
+import sys
+sys.path.insert(0, '${SLM_DIR}')
+sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
+try:
+    from learning.engagement_tracker import EngagementTracker
+    tracker = EngagementTracker()
+    print(tracker.format_for_cli())
+except ImportError:
+    print('Learning features not available. Install: pip3 install lightgbm scipy')
+except Exception as e:
+    print(f'Error: {e}')
+"
+        ;;
+
     help|--help|-h)
         cat <<EOF
 SuperLocalMemory V2 - Universal CLI
@@ -154,6 +319,14 @@ PATTERN LEARNING:
   slm patterns update      Learn patterns from memories
   slm patterns list [threshold]  List learned patterns
   slm patterns context [threshold]  Get coding identity context
+  slm patterns correct <id> <value>  Correct a learned pattern
+
+LEARNING (v2.7):
+  slm useful <id> [id...]  Mark memories as useful (ranking feedback)
+  slm learning status      Learning system status
+  slm learning retrain     Force model retrain
+  slm learning reset       Delete all learning data (memories preserved)
+  slm engagement           Show engagement metrics
 
 WEB DASHBOARD:
   slm ui [PORT]            Start web dashboard (default port 8765)
@@ -187,13 +360,13 @@ DOCUMENTATION:
   README: https://github.com/varun369/SuperLocalMemoryV2
   Docs: ~/.claude-memory/docs/
 
-VERSION: 2.4.1
+VERSION: 2.7.0
 EOF
         ;;
 
     version|--version|-v)
         echo "SuperLocalMemory V2 - Universal CLI"
-        echo "Version: 2.4.1"
+        echo "Version: 2.7.0"
         echo "Database: $SLM_DIR/memory.db"
         ;;
 
@@ -213,6 +386,9 @@ EOF
         echo "  profile   - Manage profiles"
         echo "  graph     - Knowledge graph operations"
         echo "  patterns  - Pattern learning"
+        echo "  useful    - Mark memories as useful"
+        echo "  learning  - Learning system management"
+        echo "  engagement - Show engagement metrics"
         echo "  help      - Show detailed help"
         echo ""
         echo "Run 'slm help' for more information"

package/bin/superlocalmemoryv2:learning

@@ -0,0 +1,4 @@
+#!/bin/bash
+# SuperLocalMemory V2 - Learning System Status
+SLM_DIR="${HOME}/.claude-memory"
+exec "${SLM_DIR}/bin/slm" learning "${@:-status}"

package/bin/superlocalmemoryv2:patterns

@@ -0,0 +1,4 @@
+#!/bin/bash
+# SuperLocalMemory V2 - Show Learned Patterns
+SLM_DIR="${HOME}/.claude-memory"
+exec "${SLM_DIR}/bin/slm" patterns list "$@"

package/docs/ACCESSIBILITY.md

@@ -0,0 +1,291 @@
+# Accessibility Features - SuperLocalMemory V2.6.5
+
+**Last Updated:** February 16, 2026
+**Author:** Varun Pratap Bhardwaj
+
+---
+
+## Overview
+
+SuperLocalMemory V2.6.5 includes comprehensive keyboard navigation and screen reader support for the interactive knowledge graph, making it fully accessible to users with disabilities.
+
+## Keyboard Navigation
+
+### Graph Container Focus
+
+The graph container (`#graph-container`) is focusable via keyboard:
+
+- **Focus method:** Click graph OR press `Tab` from controls above
+- **Visual indicator:** Browser native focus outline + first node highlighted with blue border
+- **ARIA role:** `role="application"` signals custom keyboard handling
+
+### Node Navigation
+
+| Key | Action |
+|-----|--------|
+| **Tab** | Move to next node (cycles through all nodes) |
+| **Shift+Tab** | Move to previous node |
+| **→** (Right Arrow) | Move to nearest node on the right |
+| **←** (Left Arrow) | Move to nearest node on the left |
+| **↓** (Down Arrow) | Move to nearest node below |
+| **↑** (Up Arrow) | Move to nearest node above |
+| **Home** | Jump to first node |
+| **End** | Jump to last node |
+
+**Arrow Key Algorithm:**
+- Finds nodes in specified direction (based on X/Y coordinates)
+- Prioritizes nodes closer to current position
+- Combines Euclidean distance with directional score
+- Ensures no "stuck" states (always finds a valid next node)
+
+### Actions
+
+| Key | Action |
+|-----|--------|
+| **Enter** or **Space** | Open modal for focused node |
+| **Escape** | Clear active filter OR blur graph (if no filter) |
+
+### Visual Focus Indicator
+
+Focused nodes have the CSS class `.keyboard-focused` with:
+
+```css
+border-width: 5px;
+border-color: #0066ff;
+border-style: solid;
+box-shadow: 0 0 15px #0066ff;
+```
+
+The graph smoothly animates to center the focused node in the viewport.
+
+---
+
+## Screen Reader Support
+
+### ARIA Attributes
+
+#### Graph Container
+
+```html
+<div id="graph-container"
+     role="application"
+     aria-label="Interactive knowledge graph - use Tab to navigate nodes, Enter to view details, Arrow keys to move between adjacent nodes, Escape to clear filters"
+     aria-describedby="graph-stats">
+</div>
+```
+
+- **`role="application"`** - Signals custom keyboard handling
+- **`aria-label`** - Provides usage instructions
+- **`aria-describedby`** - Links to graph statistics (node/edge count)
+
+#### Status Regions
+
+```html
+<div id="graph-status-full" role="status" aria-live="polite">
+    Showing all memories
+</div>
+
+<div id="graph-status-filtered" role="status" aria-live="polite">
+    Viewing Cluster X (Y memories)
+</div>
+```
+
+- **`role="status"`** - Semantic status information
+- **`aria-live="polite"`** - Announces changes when user is idle
+
+#### Hidden Status Region
+
+An off-screen status region announces keyboard navigation events:
+
+```html
+<div id="graph-sr-status"
+     role="status"
+     aria-live="polite"
+     aria-atomic="true"
+     style="position:absolute; left:-10000px; width:1px; height:1px; overflow:hidden;">
+</div>
+```
+
+This element is invisible but screen readers announce its content changes.
+
+#### Buttons
+
+All interactive buttons have `aria-label` attributes:
+
+```html
+<button aria-label="Refresh graph data">...</button>
+<button aria-label="Clear filter and show all memories">...</button>
+<button aria-label="Toggle dark mode">...</button>
+```
+
+#### Dropdowns
+
+Form controls have proper labels:
+
+```html
+<label for="graph-layout-selector">Layout Algorithm:</label>
+<select id="graph-layout-selector" aria-label="Select graph layout algorithm">
+```
+
+### Screen Reader Announcements
+
+The `updateScreenReaderStatus()` function announces:
+
+1. **Graph load:** "Graph loaded with X memories and Y connections"
+2. **Node navigation:** "Memory 123: SuperLocalMemory Project, Cluster 2, Importance 8 out of 10"
+3. **Filter cleared:** "Filters cleared, showing all memories"
+
+These announcements are sent to the hidden `#graph-sr-status` region.
+
+---
+
+## Modal Focus Management
+
+### Opening Modal
+
+When `openMemoryModal()` is called:
+
+1. **Store last focused element:** `window.lastFocusedElement = document.activeElement`
+2. **Bootstrap modal shown event:** Focus moves to first button in modal
+3. **Tab order:** Close button → Modal content → Action buttons → Footer buttons
+
+### Closing Modal
+
+When modal closes (via Bootstrap `hidden.bs.modal` event):
+
+1. **Restore focus:** `window.lastFocusedElement.focus()`
+2. **Clear stored element:** `window.lastFocusedElement = null`
+3. **User can continue:** Keyboard navigation resumes from same node
+
+This ensures users don't lose their place in the graph when opening/closing modals.
+
+---
+
+## Skip Links
+
+A skip link is provided for keyboard users:
+
+```html
+<a href="#memories-pane" class="visually-hidden-focusable">Skip to Memories list</a>
+```
+
+This link is invisible until focused (via Tab), allowing users to bypass the graph and jump directly to the Memories tab.
+
+---
+
+## Testing with Screen Readers
+
+### macOS VoiceOver
+
+1. **Enable:** Press `Cmd+F5`
+2. **Navigate:** `Control+Option+Arrow keys`
+3. **Read current element:** `Control+Option+A`
+4. **Test focus:** Tab through graph → Verify announcements
+
+### Windows NVDA
+
+1. **Install:** Download from [nvaccess.org](https://www.nvaccess.org/)
+2. **Start:** `Control+Alt+N`
+3. **Navigate:** Arrow keys
+4. **Browse mode:** Press `Insert+Space` to toggle
+
+### Windows JAWS
+
+1. **Commercial software:** Most widely used screen reader
+2. **Navigate:** Arrow keys + Tab
+3. **Read mode:** Virtual cursor navigation
+
+### Linux Orca
+
+1. **Enable:** `Alt+F2`, type "orca"
+2. **Configure:** `orca --setup`
+3. **Navigate:** Arrow keys
+
+---
+
+## Compliance
+
+### WCAG 2.1 AA Compliance
+
+| Criterion | Status | Implementation |
+|-----------|--------|----------------|
+| **1.3.1 Info and Relationships** | ✅ Pass | Semantic HTML, ARIA roles |
+| **2.1.1 Keyboard** | ✅ Pass | Full keyboard navigation |
+| **2.1.2 No Keyboard Trap** | ✅ Pass | Escape key blurs graph |
+| **2.4.3 Focus Order** | ✅ Pass | Logical tab order |
+| **2.4.7 Focus Visible** | ✅ Pass | Blue outline on focused nodes |
+| **3.2.1 On Focus** | ✅ Pass | No unexpected context changes |
+| **4.1.2 Name, Role, Value** | ✅ Pass | ARIA labels on all controls |
+| **4.1.3 Status Messages** | ✅ Pass | aria-live regions |
+
+### Section 508 Compliance
+
+- ✅ **(a) Keyboard access** - All graph functions accessible via keyboard
+- ✅ **(c) Color contrast** - Blue focus indicator meets 4.5:1 contrast ratio
+- ✅ **(d) Screen reader compatible** - ARIA labels and live regions
+
+---
+
+## Developer Notes
+
+### Code Location
+
+- **Keyboard navigation:** `/ui/js/graph-cytoscape.js` (lines 950-1150)
+- **Modal focus management:** `/ui/js/modal.js` (lines 10-18, 142-160)
+- **ARIA attributes:** `/ui/index.html` (graph-pane section)
+
+### Key Functions
+
+| Function | Purpose |
+|----------|---------|
+| `setupKeyboardNavigation()` | Attaches keyboard event handlers to graph container |
+| `focusNodeAtIndex(index)` | Highlights node and centers viewport |
+| `moveToAdjacentNode(direction, currentNode)` | Finds nearest node in specified direction |
+| `announceNode(node)` | Sends node info to screen reader |
+| `updateScreenReaderStatus(message)` | Updates hidden status region |
+
+### Global State Variables
+
+```javascript
+var focusedNodeIndex = 0;              // Currently focused node index
+var keyboardNavigationEnabled = false; // Is keyboard nav active?
+var lastFocusedElement = null;         // For modal focus return
+```
+
+### Cytoscape.js Style Class
+
+```javascript
+{
+    selector: 'node.keyboard-focused',
+    style: {
+        'border-width': 5,
+        'border-color': '#0066ff',
+        'border-style': 'solid',
+        'box-shadow': '0 0 15px #0066ff'
+    }
+}
+```
+
+---
+
+## Future Enhancements (v2.7+)
+
+1. **Voice commands:** Integrate Web Speech API for voice navigation
+2. **Braille support:** Test with refreshable Braille displays
+3. **High contrast mode:** Additional theme for low vision users
+4. **Keyboard shortcuts help:** Press `?` to show keyboard shortcuts overlay
+5. **Focus trapping in modal:** Prevent Tab from leaving modal when open
+
+---
+
+## Feedback
+
+If you encounter accessibility issues, please report them:
+
+- **GitHub Issues:** https://github.com/varun369/SuperLocalMemoryV2/issues
+- **Label:** Use `accessibility` tag
+- **Include:** Browser, screen reader (if applicable), and steps to reproduce
+
+---
+
+**Copyright © 2026 Varun Pratap Bhardwaj - MIT License**

package/docs/ARCHITECTURE.md

@@ -85,7 +85,7 @@ Simple Storage → Intelligent Organization → Adaptive Learning
 
 The MCP server provides native integration with modern AI tools:
 
-**8 Tools:**
+**12 Tools:**
 - `remember(content, tags, project)` - Save memories
 - `recall(query, limit)` - Search memories
 - `list_recent(limit)` - Recent memories
@@ -94,12 +94,18 @@ The MCP server provides native integration with modern AI tools:
 - `switch_profile(name)` - Change profile
 - `search(query)` - Search memories (OpenAI MCP spec for ChatGPT Connectors)
 - `fetch(id)` - Fetch memory by ID (OpenAI MCP spec for ChatGPT Connectors)
+- `backup_status()` - Auto-backup status
+- `memory_used(memory_id, query, usefulness)` - Feedback for learning (v2.7)
+- `get_learned_patterns(min_confidence, category)` - Retrieve learned patterns (v2.7)
+- `correct_pattern(pattern_id, correct_value)` - Correct a learned pattern (v2.7)
 
-**4 Resources:**
-- `memory://recent` - Recent memories feed
+**6 Resources:**
+- `memory://recent/{limit}` - Recent memories feed
 - `memory://stats` - System statistics
 - `memory://graph/clusters` - Graph clusters
 - `memory://patterns/identity` - Learned patterns
+- `memory://learning/status` - Learning system status (v2.7)
+- `memory://engagement` - Engagement metrics (v2.7)
 
 **2 Prompts:**
 - `coding_identity_prompt` - User's coding style
@@ -221,16 +227,16 @@ SuperLocalMemory V2 uses a hierarchical, additive architecture where each layer
                             ↑
 ┌─────────────────────────────────────────────────────────────────┐
 │ Layer 6: MCP Integration (mcp_server.py)                       │
-│  6 tools, 4 resources, 2 prompts                               │
+│  12 tools, 6 resources, 2 prompts                              │
 │  Auto-configured for Claude Desktop, Cursor, Windsurf, etc.   │
 │  Output: Native AI tool access via Model Context Protocol      │
 └─────────────────────────────────────────────────────────────────┘
                             ↑
 ┌─────────────────────────────────────────────────────────────────┐
 │ Layer 5: Skills Layer (skills/*)                               │
-│  6 slash-command skills for Claude Code, Continue.dev, Cody    │
+│  7 slash-command skills for Claude Code, Continue.dev, Cody    │
 │  slm-remember, slm-recall, slm-status, slm-list-recent,       │
-│  slm-build-graph, slm-switch-profile                           │
+│  slm-build-graph, slm-switch-profile, slm-show-patterns       │
 │  Output: Familiar /command interface across AI tools           │
 └─────────────────────────────────────────────────────────────────┘
                             ↑