superlocalmemory 2.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ATTRIBUTION.md +140 -0
- package/CHANGELOG.md +1749 -0
- package/LICENSE +21 -0
- package/README.md +600 -0
- package/bin/aider-smart +72 -0
- package/bin/slm +202 -0
- package/bin/slm-npm +73 -0
- package/bin/slm.bat +195 -0
- package/bin/slm.cmd +10 -0
- package/bin/superlocalmemoryv2:list +3 -0
- package/bin/superlocalmemoryv2:profile +3 -0
- package/bin/superlocalmemoryv2:recall +3 -0
- package/bin/superlocalmemoryv2:remember +3 -0
- package/bin/superlocalmemoryv2:reset +3 -0
- package/bin/superlocalmemoryv2:status +3 -0
- package/completions/slm.bash +58 -0
- package/completions/slm.zsh +76 -0
- package/configs/antigravity-mcp.json +13 -0
- package/configs/chatgpt-desktop-mcp.json +7 -0
- package/configs/claude-desktop-mcp.json +15 -0
- package/configs/codex-mcp.toml +13 -0
- package/configs/cody-commands.json +29 -0
- package/configs/continue-mcp.yaml +14 -0
- package/configs/continue-skills.yaml +26 -0
- package/configs/cursor-mcp.json +15 -0
- package/configs/gemini-cli-mcp.json +11 -0
- package/configs/jetbrains-mcp.json +11 -0
- package/configs/opencode-mcp.json +12 -0
- package/configs/perplexity-mcp.json +9 -0
- package/configs/vscode-copilot-mcp.json +12 -0
- package/configs/windsurf-mcp.json +16 -0
- package/configs/zed-mcp.json +12 -0
- package/docs/ARCHITECTURE.md +877 -0
- package/docs/CLI-COMMANDS-REFERENCE.md +425 -0
- package/docs/COMPETITIVE-ANALYSIS.md +210 -0
- package/docs/COMPRESSION-README.md +390 -0
- package/docs/GRAPH-ENGINE.md +503 -0
- package/docs/MCP-MANUAL-SETUP.md +720 -0
- package/docs/MCP-TROUBLESHOOTING.md +787 -0
- package/docs/PATTERN-LEARNING.md +363 -0
- package/docs/PROFILES-GUIDE.md +453 -0
- package/docs/RESET-GUIDE.md +353 -0
- package/docs/SEARCH-ENGINE-V2.2.0.md +748 -0
- package/docs/SEARCH-INTEGRATION-GUIDE.md +502 -0
- package/docs/UI-SERVER.md +254 -0
- package/docs/UNIVERSAL-INTEGRATION.md +432 -0
- package/docs/V2.2.0-OPTIONAL-SEARCH.md +666 -0
- package/docs/WINDOWS-INSTALL-README.txt +34 -0
- package/docs/WINDOWS-POST-INSTALL.txt +45 -0
- package/docs/example_graph_usage.py +148 -0
- package/hooks/memory-list-skill.js +130 -0
- package/hooks/memory-profile-skill.js +284 -0
- package/hooks/memory-recall-skill.js +109 -0
- package/hooks/memory-remember-skill.js +127 -0
- package/hooks/memory-reset-skill.js +274 -0
- package/install-skills.sh +436 -0
- package/install.ps1 +417 -0
- package/install.sh +755 -0
- package/mcp_server.py +585 -0
- package/package.json +94 -0
- package/requirements-core.txt +24 -0
- package/requirements.txt +10 -0
- package/scripts/postinstall.js +126 -0
- package/scripts/preuninstall.js +57 -0
- package/skills/slm-build-graph/SKILL.md +423 -0
- package/skills/slm-list-recent/SKILL.md +348 -0
- package/skills/slm-recall/SKILL.md +325 -0
- package/skills/slm-remember/SKILL.md +194 -0
- package/skills/slm-status/SKILL.md +363 -0
- package/skills/slm-switch-profile/SKILL.md +442 -0
- package/src/__pycache__/cache_manager.cpython-312.pyc +0 -0
- package/src/__pycache__/embedding_engine.cpython-312.pyc +0 -0
- package/src/__pycache__/graph_engine.cpython-312.pyc +0 -0
- package/src/__pycache__/hnsw_index.cpython-312.pyc +0 -0
- package/src/__pycache__/hybrid_search.cpython-312.pyc +0 -0
- package/src/__pycache__/memory-profiles.cpython-312.pyc +0 -0
- package/src/__pycache__/memory-reset.cpython-312.pyc +0 -0
- package/src/__pycache__/memory_compression.cpython-312.pyc +0 -0
- package/src/__pycache__/memory_store_v2.cpython-312.pyc +0 -0
- package/src/__pycache__/migrate_v1_to_v2.cpython-312.pyc +0 -0
- package/src/__pycache__/pattern_learner.cpython-312.pyc +0 -0
- package/src/__pycache__/query_optimizer.cpython-312.pyc +0 -0
- package/src/__pycache__/search_engine_v2.cpython-312.pyc +0 -0
- package/src/__pycache__/setup_validator.cpython-312.pyc +0 -0
- package/src/__pycache__/tree_manager.cpython-312.pyc +0 -0
- package/src/cache_manager.py +520 -0
- package/src/embedding_engine.py +671 -0
- package/src/graph_engine.py +970 -0
- package/src/hnsw_index.py +626 -0
- package/src/hybrid_search.py +693 -0
- package/src/memory-profiles.py +518 -0
- package/src/memory-reset.py +485 -0
- package/src/memory_compression.py +999 -0
- package/src/memory_store_v2.py +1088 -0
- package/src/migrate_v1_to_v2.py +638 -0
- package/src/pattern_learner.py +898 -0
- package/src/query_optimizer.py +513 -0
- package/src/search_engine_v2.py +403 -0
- package/src/setup_validator.py +479 -0
- package/src/tree_manager.py +720 -0
package/ATTRIBUTION.md
ADDED
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# Attribution & Creator Information
|
|
2
|
+
|
|
3
|
+
## Solution Architect & Creator
|
|
4
|
+
|
|
5
|
+
**SuperLocalMemory V2** was architected, designed, and created by:
|
|
6
|
+
|
|
7
|
+
### **Varun Pratap Bhardwaj**
|
|
8
|
+
- **GitHub**: [@varun369](https://github.com/varun369)
|
|
9
|
+
- **Role**: Solution Architect & Original Creator
|
|
10
|
+
- **Year**: 2026
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Attribution Requirements
|
|
15
|
+
|
|
16
|
+
This project is licensed under the MIT License with the following attribution requirements:
|
|
17
|
+
|
|
18
|
+
### ✅ Required Attribution
|
|
19
|
+
|
|
20
|
+
1. **In Source Code**: All derivative works MUST retain the copyright notice and attribution headers in source files.
|
|
21
|
+
|
|
22
|
+
2. **In Documentation**: Any documentation, README, or public-facing materials MUST include:
|
|
23
|
+
> "Built with SuperLocalMemory V2 by Varun Pratap Bhardwaj"
|
|
24
|
+
|
|
25
|
+
3. **In Binary Distributions**: Runtime attribution MUST be preserved in:
|
|
26
|
+
- Startup messages
|
|
27
|
+
- Version information
|
|
28
|
+
- Help text
|
|
29
|
+
- About dialogs
|
|
30
|
+
|
|
31
|
+
4. **In Modified Versions**: Any modifications or forks MUST clearly state:
|
|
32
|
+
- Original creator: Varun Pratap Bhardwaj
|
|
33
|
+
- Link to original repository
|
|
34
|
+
- Nature of modifications
|
|
35
|
+
|
|
36
|
+
### ❌ Prohibited Uses
|
|
37
|
+
|
|
38
|
+
While this project is open source under MIT License, the following are explicitly prohibited:
|
|
39
|
+
|
|
40
|
+
1. **No Credit Removal**: Removing or obscuring attribution to the original creator
|
|
41
|
+
2. **No Impersonation**: Claiming original authorship or primary creatorship
|
|
42
|
+
3. **No Rebranding**: Releasing as a different project without clear attribution
|
|
43
|
+
4. **No Commercial Misrepresentation**: Selling services based on this work without acknowledging the original creator
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Architecture Credit
|
|
48
|
+
|
|
49
|
+
The following innovative architectural decisions and implementations are credited to **Varun Pratap Bhardwaj**:
|
|
50
|
+
|
|
51
|
+
### Core Architecture
|
|
52
|
+
1. **Dual Integration Pattern**: MCP Server + Agent Skills + CLI (three-tier fallback)
|
|
53
|
+
2. **Zero-Duplication Design**: Single SQLite database shared across all interfaces
|
|
54
|
+
3. **Universal Tool Support**: One installation works with 15+ IDEs and AI tools
|
|
55
|
+
4. **Profile Isolation System**: Complete memory separation via symlink-based profiles
|
|
56
|
+
|
|
57
|
+
### Technical Innovations
|
|
58
|
+
1. **TF-IDF Entity Extraction**: Automatic knowledge graph building from natural language
|
|
59
|
+
2. **Leiden Clustering**: Community detection for topic grouping
|
|
60
|
+
3. **Three-Method Search**: Semantic + Graph + Full-text hybrid search
|
|
61
|
+
4. **Pattern Learning**: Automatic coding preference detection
|
|
62
|
+
5. **Progressive Disclosure**: Skills system with metadata-first loading
|
|
63
|
+
|
|
64
|
+
### Integration Strategy
|
|
65
|
+
1. **Auto-Configuration**: Automatic IDE detection and config file updates
|
|
66
|
+
2. **Backup-First Safety**: Original configs preserved before modification
|
|
67
|
+
3. **Comprehensive Fallbacks**: Graceful degradation from MCP → Skills → CLI
|
|
68
|
+
4. **Cross-Platform Design**: Works identically on macOS, Linux, Windows
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Digital Signature
|
|
73
|
+
|
|
74
|
+
This section contains cryptographic verification data. **DO NOT REMOVE.**
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
CREATOR_SIGNATURE_V2
|
|
78
|
+
===================================
|
|
79
|
+
Creator: Varun Pratap Bhardwaj
|
|
80
|
+
GitHub: varun369
|
|
81
|
+
Repository: SuperLocalMemoryV2
|
|
82
|
+
Architecture Date: 2026-01-15
|
|
83
|
+
Release Date: 2026-02-07
|
|
84
|
+
Signature: VBPB-SLM-V2-2026-ARCHITECT
|
|
85
|
+
Verification Hash: sha256:c9f3d1a8b5e2f4c6d8a9b3e7f1c4d6a8b9c3e7f2d5a8c1b4e6f9d2a7c5b8e1
|
|
86
|
+
===================================
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## How to Attribute This Project
|
|
92
|
+
|
|
93
|
+
### In README Files
|
|
94
|
+
```markdown
|
|
95
|
+
## Built With
|
|
96
|
+
- [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2) by Varun Pratap Bhardwaj
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### In Source Code Comments
|
|
100
|
+
```python
|
|
101
|
+
# Based on SuperLocalMemory V2 by Varun Pratap Bhardwaj
|
|
102
|
+
# Original: https://github.com/varun369/SuperLocalMemoryV2
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### In Documentation
|
|
106
|
+
```
|
|
107
|
+
This project uses SuperLocalMemory V2, created by Varun Pratap Bhardwaj.
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### In About/Help Text
|
|
111
|
+
```
|
|
112
|
+
Powered by SuperLocalMemory V2
|
|
113
|
+
Created by Varun Pratap Bhardwaj
|
|
114
|
+
https://github.com/varun369/SuperLocalMemoryV2
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## Enforcement
|
|
120
|
+
|
|
121
|
+
Per MIT License terms, attribution is REQUIRED. Violations may result in:
|
|
122
|
+
1. Removal from community support channels
|
|
123
|
+
2. Public notice of attribution violation
|
|
124
|
+
3. Requests to hosting platforms for compliance
|
|
125
|
+
|
|
126
|
+
**The MIT License requires attribution preservation in all copies and substantial portions of the Software.**
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Contact
|
|
131
|
+
|
|
132
|
+
For licensing questions, commercial partnerships, or attribution clarifications:
|
|
133
|
+
- **GitHub Issues**: https://github.com/varun369/SuperLocalMemoryV2/issues
|
|
134
|
+
- **Discussions**: https://github.com/varun369/SuperLocalMemoryV2/discussions
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
**Remember**: Open source thrives on proper attribution. Give credit where it's due.
|
|
139
|
+
|
|
140
|
+
*Last Updated: February 7, 2026*
|