superlocalmemory 2.7.6 → 2.8.1

package/README.md

@@ -1,21 +1,22 @@
 <p align="center">
-  <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory V2" width="200"/>
+  <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V2</h1>
+<h1 align="center">SuperLocalMemory</h1>
 <p align="center"><strong>Your AI Finally Remembers You</strong></p>
 
 <p align="center">
-  <strong>⚡ Created & Architected by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a> ⚡</strong><br/>
-  <em>Solution Architect • Original Creator • 2026</em>
+  <strong>Stop re-explaining your codebase every session. 100% local. Zero setup. Completely free.</strong>
 </p>
 
 <p align="center">
-  <strong>Stop re-explaining your codebase every session. 100% local. Zero setup. Completely free.</strong>
+  <a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/🌐_Website-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Official Website"/></a>
 </p>
 
 <p align="center">
-  <a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/🌐_Website-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Official Website"/></a>
+  <a href="https://zenodo.org/records/18709670"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18709670-blue?style=for-the-badge&logo=doi&logoColor=white" alt="DOI"/></a>
+  <a href="https://zenodo.org/records/18709670"><img src="https://img.shields.io/badge/Zenodo-Research_Paper-1682D4?style=for-the-badge&logo=zenodo&logoColor=white" alt="Zenodo"/></a>
+  <a href="https://www.researchgate.net/publication/400976053"><img src="https://img.shields.io/badge/ResearchGate-Paper-00CCBB?style=for-the-badge&logo=researchgate&logoColor=white" alt="ResearchGate"/></a>
 </p>
 
 <p align="center">
@@ -39,86 +40,114 @@
 <p align="center">
   <b>Created by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a></b> •
   <a href="https://github.com/sponsors/varun369">💖 Sponsor</a> •
-  <a href="ATTRIBUTION.md">📜 Attribution Required</a>
+  <a href="LICENSE">📜 MIT License</a>
 </p>
 
 ---
 
-## What's New in v2.7 — "Your AI Learns You"
+## Research Paper
 
-**SuperLocalMemory now learns your patterns, adapts to your workflow, and personalizes recall — all 100% locally on your machine.** No cloud. No LLM. Your behavioral data never leaves your device.
+**SuperLocalMemory: Privacy-Preserving Multi-Agent Memory with Bayesian Trust Defense Against Memory Poisoning**
 
-### Adaptive Learning System
+*Varun Pratap Bhardwaj, 2026*
 
-Your memory system evolves with you through three learning layers:
+The paper presents SuperLocalMemory's architecture for defending against OWASP ASI06 memory poisoning through local-first design, Bayesian trust scoring, and adaptive learning-to-rank — all without cloud dependencies or LLM inference calls.
 
-| Layer | What It Learns | How |
-|-------|---------------|-----|
-| **Tech Preferences** | "You prefer FastAPI over Django" (83% confidence) | Cross-project frequency analysis with Bayesian scoring |
-| **Project Context** | Detects your active project from 4 signals | Path analysis, tags, profile, content clustering |
-| **Workflow Patterns** | "You typically: docs → architecture → code → test" | Time-weighted sliding-window sequence mining |
+| Platform | Link |
+|----------|------|
+| **Zenodo** (CERN) | [DOI: 10.5281/zenodo.18709670](https://zenodo.org/records/18709670) |
+| **ResearchGate** | [Publication Page](https://www.researchgate.net/publication/400976053) |
+| **arXiv** | Submission under review |
+| **Research Portfolio** | [superlocalmemory.com/research](https://superlocalmemory.com/research) |
 
-### Three-Phase Adaptive Ranking
+If you use SuperLocalMemory in your research, please cite:
 
-Recall results get smarter over time — automatically:
+```bibtex
+@misc{bhardwaj2026superlocalmemory,
+  title={SuperLocalMemory: Privacy-Preserving Multi-Agent Memory with Bayesian Trust Defense Against Memory Poisoning},
+  author={Bhardwaj, Varun Pratap},
+  year={2026},
+  doi={10.5281/zenodo.18709670},
+  url={https://zenodo.org/records/18709670},
+  note={Preprint}
+}
+```
 
-1. **Phase 1 (Baseline):** Standard search — same as v2.6
-2. **Phase 2 (Rule-Based):** After ~20 feedback signals — boosts results matching your preferences
-3. **Phase 3 (ML Ranking):** After ~200 signals — LightGBM LambdaRank re-ranks with 9 personalized features
+---
+
+## What's New in v2.8 — "Memory That Manages Itself"
 
-### Privacy by Design — GDPR Compliant
+**SuperLocalMemory now manages its own memory lifecycle, learns from action outcomes, and provides enterprise-grade compliance — all 100% locally on your machine.**
 
-| Concern | SuperLocalMemory v2.7 | Cloud-Based Alternatives |
-|---------|----------------------|--------------------------|
-| **Where is learning data?** | `~/.claude-memory/learning.db` on YOUR machine | Their servers, their terms |
-| **Who processes your behavior?** | Local gradient boosting (no LLM, no GPU) | Cloud LLMs process your data |
-| **Right to erasure (GDPR Art. 17)?** | `slm learning reset` — one command, instant | Submit a request, wait weeks |
-| **Data portability?** | Copy the SQLite file | Vendor lock-in |
-| **Telemetry?** | Zero. Absolutely none. | Usage analytics, behavior tracking |
+### Memory Lifecycle Management (v2.8)
+Memories automatically transition through lifecycle states based on usage patterns:
+- **Active** — Frequently used, instantly available
+- **Warm** — Recently used, included in searches
+- **Cold** — Older, retrievable on demand
+- **Archived** — Compressed, restorable when needed
 
-**Your learning data is stored separately from your memories.** Delete `learning.db` and your memories are untouched. Delete `memory.db` and your learning patterns are untouched. Full data sovereignty.
+Configure bounds to keep your memory system fast:
+```bash
+# Check lifecycle status
+slm lifecycle-status
 
-### Research-Backed Architecture
+# Compact stale memories
+slm compact --dry-run
+```
 
-Every component is grounded in peer-reviewed research, adapted for local-first operation:
+### Behavioral Learning (v2.8)
+The system learns from what works:
+- Report outcomes: `slm report-outcome --memory-ids 1,5 --outcome success`
+- View patterns: `slm behavioral-patterns`
+- Knowledge transfers across projects automatically
 
-| Component | Research Basis |
-|-----------|---------------|
-| Two-stage retrieval pipeline | BM25 → re-ranker (eKNOW 2025) |
-| Adaptive cold-start ranking | Hierarchical meta-learning (LREC 2024) |
-| Time-weighted sequence mining | TSW-PrefixSpan (IEEE 2020) |
-| Bayesian confidence scoring | MACLA (arXiv:2512.18950) |
-| LightGBM LambdaRank | Pairwise ranking (Burges 2010, MO-LightGBM SIGIR 2025) |
-| Privacy-preserving feedback | Zero-communication design — stronger than differential privacy (ADPMF, IPM 2024) |
+### Enterprise Compliance (v2.8)
+Built for regulated environments:
+- **Access Control** — Attribute-based policies (ABAC)
+- **Audit Trail** — Tamper-evident event logging
+- **Retention Policies** — GDPR erasure, HIPAA retention, EU AI Act compliance
 
-### New MCP Tools
+### New MCP Tools (v2.8)
 
 | Tool | Purpose |
 |------|---------|
-| `memory_used` | Tell the AI which recalled memories were useful — trains the ranking model |
-| `get_learned_patterns` | See what the system has learned about your preferences |
-| `correct_pattern` | Fix a wrong pattern — your correction overrides with maximum confidence |
+| `report_outcome` | Record action outcomes for behavioral learning |
+| `get_lifecycle_status` | View memory lifecycle states |
+| `set_retention_policy` | Configure retention policies |
+| `compact_memories` | Trigger lifecycle transitions |
+| `get_behavioral_patterns` | View learned behavioral patterns |
+| `audit_trail` | Query compliance audit trail |
 
-### New CLI Commands
+### Performance
 
-```bash
-slm useful 42 87           # Mark memories as useful (ranking feedback)
-slm patterns list           # See learned tech preferences
-slm learning status         # Learning system diagnostics
-slm learning reset          # Delete all behavioral data (memories preserved)
-slm engagement              # Local engagement health metrics
-```
+| Operation | Latency |
+|-----------|---------|
+| Lifecycle evaluation | Sub-2ms |
+| Access control check | Sub-1ms |
+| Feature vector (20-dim) | Sub-5ms |
 
-**Upgrade:** `npm install -g superlocalmemory@latest` — Learning dependencies install automatically.
+**Upgrade:** `npm install -g superlocalmemory@latest` — All v2.7 behavior preserved, zero breaking changes.
 
-[Learning System Guide →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Learning-System) | [Upgrade Guide →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Upgrading-to-v2.7) | [Full Changelog](CHANGELOG.md)
+[Upgrading to v2.8](https://github.com/varun369/SuperLocalMemoryV2/wiki/Upgrading-to-v2.8) | [Full Changelog](CHANGELOG.md)
 
 ---
 
+<details>
+<summary><strong>Previous: v2.7 — "Your AI Learns You"</strong></summary>
+
+SuperLocalMemory learns your patterns, adapts to your workflow, and personalizes recall — all 100% locally. No cloud. No LLM. Your behavioral data never leaves your device.
+
+- **Adaptive Learning** — Learns tech preferences, project context, and workflow patterns
+- **Three-Phase Ranking** — Baseline → Rule-Based → ML Ranking (gets smarter over time)
+- **Privacy by Design** — Learning data stored separately, one-command GDPR erasure
+- **3 New MCP Tools** — Feedback signal, pattern transparency, and user correction
+
+</details>
+
 <details>
 <summary><strong>Previous: v2.6.5 — Interactive Knowledge Graph</strong></summary>
 
-- Fully interactive visualization with zoom, pan, click-to-explore (Cytoscape.js)
+- Fully interactive visualization with zoom, pan, and click-to-explore
 - 6 layout algorithms, smart cluster filtering, 10,000+ node performance
 - Mobile & accessibility support: touch gestures, keyboard nav, screen reader
 
@@ -141,7 +170,7 @@ SuperLocalMemory is now **production-hardened** with security, performance, and
 
 **Upgrade:** `npm install -g superlocalmemory@latest`
 
-[Interactive Architecture Diagram](https://superlocalmemory.com/architecture.html) | [Architecture Doc](docs/ARCHITECTURE-V2.5.md) | [Full Changelog](CHANGELOG.md)
+[Interactive Architecture Diagram](https://superlocalmemory.com/architecture.html) | [Architecture Doc](docs/ARCHITECTURE.md) | [Full Changelog](CHANGELOG.md)
 
 </details>
 
@@ -232,22 +261,13 @@ python3 ~/.claude-memory/ui_server.py
 | Code preferences | "I prefer React..." every time | Pattern learning knows your style |
 | Multi-project | Context constantly bleeds | Separate profiles per project |
 
-### Built on 2026 Research
-
-Not another simple key-value store. SuperLocalMemory implements **cutting-edge memory architecture** backed by peer-reviewed research:
+### Built on Peer-Reviewed Research
 
-- **PageIndex** (Meta AI) → Hierarchical memory organization
-- **GraphRAG** (Microsoft) → Knowledge graph with auto-clustering
-- **xMemory** (Stanford) → Identity pattern learning
-- **A-RAG** → Multi-level retrieval with context awareness
-- **LambdaRank** (Burges 2010, MO-LightGBM SIGIR 2025) → Adaptive re-ranking *(v2.7)*
-- **TSW-PrefixSpan** (IEEE 2020) → Time-weighted workflow pattern mining *(v2.7)*
-- **MACLA** (arXiv:2512.18950) → Bayesian temporal confidence scoring *(v2.7)*
-- **FCS** (LREC 2024) → Hierarchical cold-start mitigation *(v2.7)*
+Not another simple key-value store. SuperLocalMemory implements **cutting-edge memory architecture** backed by peer-reviewed research — hierarchical organization, knowledge graph clustering, identity pattern learning, multi-level retrieval, adaptive re-ranking, workflow sequence mining, temporal confidence scoring, and cold-start mitigation.
 
-**The only open-source implementation combining all eight approaches — entirely locally.**
+**The only open-source implementation combining all these approaches — entirely locally.**
 
-[See research citations →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Research-Foundations)
+[Read the paper →](https://zenodo.org/records/18709670)
 
 ---
 
@@ -270,52 +290,54 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 │  17+ IDEs with single database                              │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 6: MCP INTEGRATION                                   │
-│  Model Context Protocol: 12 tools, 6 resources, 2 prompts   │
+│  Model Context Protocol: 18 tools, 6 resources, 2 prompts   │
 │  Auto-configured for Cursor, Windsurf, Claude               │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 5½: ADAPTIVE LEARNING (v2.7 — NEW)                   │
 │  Three-layer learning: tech prefs + project context + flow  │
-│  LightGBM LambdaRank re-ranking (fully local, no cloud)    │
-│  Research: eKNOW 2025, MACLA, TSW-PrefixSpan, LREC 2024    │
+│  Local ML re-ranking — no cloud, no telemetry               │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 5: SKILLS LAYER                                      │
 │  7 universal slash-commands for AI assistants               │
 │  Compatible with Claude Code, Continue, Cody                │
 ├─────────────────────────────────────────────────────────────┤
-│  Layer 4: PATTERN LEARNING + MACLA                          │
-│  Bayesian confidence scoring (arXiv:2512.18950)             │
+│  Layer 4: PATTERN LEARNING                                  │
+│  Confidence-scored preference detection                     │
 │  "You prefer React over Vue" (73% confidence)               │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 3: KNOWLEDGE GRAPH + HIERARCHICAL CLUSTERING         │
-│  Recursive Leiden algorithm: "Python" → "FastAPI" → "Auth" │
-│  Community summaries with TF-IDF structured reports         │
+│  Auto-clustering: "Python" → "Web API" → "Auth"            │
+│  Community summaries with auto-generated labels             │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 2: HIERARCHICAL INDEX                                │
 │  Tree structure for fast navigation                         │
 │  O(log n) lookups instead of O(n) scans                     │
 ├─────────────────────────────────────────────────────────────┤
 │  Layer 1: RAW STORAGE                                       │
-│  SQLite + Full-text search + TF-IDF vectors                 │
+│  SQLite + Full-text search + vector search                  │
 │  Compression: 60-96% space savings                          │
 └─────────────────────────────────────────────────────────────┘
 ```
 
 ### Key Capabilities
 
-- **[Adaptive Learning System](https://github.com/varun369/SuperLocalMemoryV2/wiki/Learning-System)** — Learns your tech preferences, workflow patterns, and project context. Personalizes recall ranking using local ML (LightGBM). Zero cloud dependency. *New in v2.7*
-- **[Knowledge Graphs](https://github.com/varun369/SuperLocalMemoryV2/wiki/Knowledge-Graph)** — Automatic relationship discovery. Interactive visualization with zoom, pan, click.
-- **[Pattern Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Pattern-Learning)** — Learns your coding preferences and style automatically.
-- **[Multi-Profile Support](https://github.com/varun369/SuperLocalMemoryV2/wiki/Using-Memory-Profiles)** — Isolated contexts for work, personal, clients. Zero context bleeding.
+- **[Adaptive Learning System](https://github.com/varun369/SuperLocalMemoryV2/wiki/Learning-System)** — Learns your tech preferences, workflow patterns, and project context. Personalizes recall ranking using local ML. Zero cloud dependency. *New in v2.7*
+- **[Knowledge Graphs](https://github.com/varun369/SuperLocalMemoryV2/wiki/Knowledge-Graph-Guide)** — Automatic relationship discovery. Interactive visualization with zoom, pan, click.
+- **[Pattern Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Pattern-Learning-Explained)** — Learns your coding preferences and style automatically.
+- **[Multi-Profile Support](https://github.com/varun369/SuperLocalMemoryV2/wiki/Multi-Profile-Workflows)** — Isolated contexts for work, personal, clients. Zero context bleeding.
 - **[Hybrid Search](https://github.com/varun369/SuperLocalMemoryV2/wiki/Advanced-Search)** — Semantic + FTS5 + Graph retrieval combined for maximum accuracy.
 - **[Visualization Dashboard](https://github.com/varun369/SuperLocalMemoryV2/wiki/Visualization-Dashboard)** — Web UI for timeline, search, graph exploration, analytics.
 - **[Framework Integrations](docs/FRAMEWORK-INTEGRATIONS.md)** — Use with LangChain and LlamaIndex applications.
 - **[Real-Time Events](https://github.com/varun369/SuperLocalMemoryV2/wiki/Real-Time-Event-System)** — Live notifications via SSE/WebSocket/Webhooks when memories change.
+- **[Memory Lifecycle](https://github.com/varun369/SuperLocalMemoryV2/wiki/Memory-Lifecycle)** — Automatic state transitions (Active → Warm → Cold → Archived) with bounded growth guarantees. *New in v2.8*
+- **[Behavioral Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Behavioral-Learning)** — Learns from action outcomes, extracts success/failure patterns, transfers knowledge across projects. *New in v2.8*
+- **[Enterprise Compliance](https://github.com/varun369/SuperLocalMemoryV2/wiki/Enterprise-Compliance)** — ABAC access control, tamper-evident audit trail, GDPR/HIPAA/EU AI Act retention policies. *New in v2.8*
 
 ---
 
 ## 🌐 Works Everywhere
 
-**SuperLocalMemory V2 is the ONLY memory system that works across ALL your tools:**
+**SuperLocalMemory is the ONLY memory system that works across ALL your tools:**
 
 ### Supported IDEs & Tools
 
@@ -340,7 +362,7 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 1. **MCP (Model Context Protocol)** — Auto-configured for Cursor, Windsurf, Claude Desktop
    - AI assistants get natural access to your memory
    - No manual commands needed
-   - "Remember that we use FastAPI" just works
+   - "Remember that we use this framework" just works
 
 2. **Skills & Commands** — For Claude Code, Continue.dev, Cody
    - `/superlocalmemoryv2:remember` in Claude Code
@@ -369,11 +391,11 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 | **Supermemory** | 1M tokens, 10K queries | $19-399/mo | Not local, no graphs |
 | **Personal.AI** | ❌ No free tier | $33/month | Cloud-only, closed ecosystem |
 | **Letta/MemGPT** | Self-hosted (complex) | TBD | Requires significant setup |
-| **SuperLocalMemory V2** | **Unlimited** | **$0 forever** | **Nothing.** |
+| **SuperLocalMemory** | **Unlimited** | **$0 forever** | **Nothing.** |
 
 ### What Actually Matters
 
-| Feature | Mem0 | Zep | Khoj | Letta | **SuperLocalMemory V2** |
+| Feature | Mem0 | Zep | Khoj | Letta | **SuperLocalMemory** |
 |---------|------|-----|------|-------|------------------------|
 | **Works in Cursor** | Cloud Only | ❌ | ❌ | ❌ | ✅ **Local** |
 | **Works in Windsurf** | Cloud Only | ❌ | ❌ | ❌ | ✅ **Local** |
@@ -388,7 +410,7 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 | **Zero Setup** | ❌ | ❌ | ❌ | ❌ | ✅ |
 | **Completely Free** | Limited | Limited | Partial | ✅ | ✅ |
 
-**SuperLocalMemory V2 is the ONLY solution that:**
+**SuperLocalMemory is the ONLY solution that:**
 - ✅ **Learns and adapts** locally — no cloud LLM needed for personalization
 - ✅ Works across 17+ IDEs and CLI tools
 - ✅ Remains 100% local (no cloud dependencies)
@@ -421,7 +443,7 @@ For typical personal use (under 500 memories), search results return faster than
 | 2 AI tools simultaneously | **220/sec** | 0 |
 | 5 AI tools simultaneously | **130/sec** | 0 |
 
-WAL mode + serialized write queue = zero "database is locked" errors, ever.
+Concurrent-safe architecture = zero "database is locked" errors, ever.
 
 ### Storage
 
@@ -434,7 +456,7 @@ WAL mode + serialized write queue = zero "database is locked" errors, ever.
 | 100 | 0.28s |
 | 1,000 | 10.6s |
 
-Leiden clustering discovers 6-7 natural topic communities automatically.
+Auto-clustering discovers 6-7 natural topic communities from your memories.
 
 [Full benchmark details →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Performance-Benchmarks)
 
@@ -479,8 +501,12 @@ python ~/.claude-memory/ui_server.py                     # Launch web UI
 | [Visualization Dashboard](https://github.com/varun369/SuperLocalMemoryV2/wiki/Visualization-Dashboard) | Interactive web UI guide |
 | [Interactive Graph](https://github.com/varun369/SuperLocalMemoryV2/wiki/Using-Interactive-Graph) | Graph exploration guide (NEW v2.6.5) |
 | [Framework Integrations](docs/FRAMEWORK-INTEGRATIONS.md) | LangChain & LlamaIndex setup |
-| [Knowledge Graph](docs/GRAPH-ENGINE.md) | How clustering works |
+| [Knowledge Graph](https://github.com/varun369/SuperLocalMemoryV2/wiki/Knowledge-Graph-Guide) | How clustering works |
 | [Pattern Learning](docs/PATTERN-LEARNING.md) | Identity extraction |
+| [Memory Lifecycle](https://github.com/varun369/SuperLocalMemoryV2/wiki/Memory-Lifecycle) | Lifecycle states, compaction, bounded growth (v2.8) |
+| [Behavioral Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Behavioral-Learning) | Action outcomes, pattern extraction (v2.8) |
+| [Enterprise Compliance](https://github.com/varun369/SuperLocalMemoryV2/wiki/Enterprise-Compliance) | ABAC, audit trail, retention policies (v2.8) |
+| [Upgrading to v2.8](https://github.com/varun369/SuperLocalMemoryV2/wiki/Upgrading-to-v2.8) | Migration guide from v2.7 |
 | [API Reference](docs/API-REFERENCE.md) | Python API documentation |
 
 ---

package/api_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 - FastAPI UI Server
 Provides REST endpoints for memory visualization and exploration.
@@ -681,6 +671,29 @@ async def get_tree():
     }
 
 
+# ============================================================================
+# 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
+
+
 # ============================================================================
 # Server Startup
 # ============================================================================

package/bin/slm

@@ -55,6 +55,23 @@ case "$1" in
         "$SLM_DIR/bin/superlocalmemoryv2:profile" "$@"
         ;;
 
+    switch-profile)
+        shift
+        # Convenience alias: "slm switch-profile <name>" -> "slm profile switch <name>"
+        "$SLM_DIR/bin/superlocalmemoryv2:profile" switch "$@"
+        ;;
+
+    list-profiles)
+        # Convenience alias: "slm list-profiles" -> "slm profile list"
+        "$SLM_DIR/bin/superlocalmemoryv2:profile" list
+        ;;
+
+    create-profile)
+        shift
+        # Convenience alias: "slm create-profile <name>" -> "slm profile create <name>"
+        "$SLM_DIR/bin/superlocalmemoryv2:profile" create "$@"
+        ;;
+
     reset)
         shift
         # Calls existing command - no duplicate logic
@@ -310,6 +327,9 @@ PROFILE MANAGEMENT:
   slm profile switch <name> Switch to profile
   slm profile delete <name> Delete profile
   slm profile current      Show current profile
+  slm switch-profile <name> Shortcut for profile switch
+  slm list-profiles         Shortcut for profile list
+  slm create-profile <name> Shortcut for profile create
 
 KNOWLEDGE GRAPH:
   slm graph build          Build/rebuild knowledge graph