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.
Files changed (100) hide show
  1. package/ATTRIBUTION.md +140 -0
  2. package/CHANGELOG.md +1749 -0
  3. package/LICENSE +21 -0
  4. package/README.md +600 -0
  5. package/bin/aider-smart +72 -0
  6. package/bin/slm +202 -0
  7. package/bin/slm-npm +73 -0
  8. package/bin/slm.bat +195 -0
  9. package/bin/slm.cmd +10 -0
  10. package/bin/superlocalmemoryv2:list +3 -0
  11. package/bin/superlocalmemoryv2:profile +3 -0
  12. package/bin/superlocalmemoryv2:recall +3 -0
  13. package/bin/superlocalmemoryv2:remember +3 -0
  14. package/bin/superlocalmemoryv2:reset +3 -0
  15. package/bin/superlocalmemoryv2:status +3 -0
  16. package/completions/slm.bash +58 -0
  17. package/completions/slm.zsh +76 -0
  18. package/configs/antigravity-mcp.json +13 -0
  19. package/configs/chatgpt-desktop-mcp.json +7 -0
  20. package/configs/claude-desktop-mcp.json +15 -0
  21. package/configs/codex-mcp.toml +13 -0
  22. package/configs/cody-commands.json +29 -0
  23. package/configs/continue-mcp.yaml +14 -0
  24. package/configs/continue-skills.yaml +26 -0
  25. package/configs/cursor-mcp.json +15 -0
  26. package/configs/gemini-cli-mcp.json +11 -0
  27. package/configs/jetbrains-mcp.json +11 -0
  28. package/configs/opencode-mcp.json +12 -0
  29. package/configs/perplexity-mcp.json +9 -0
  30. package/configs/vscode-copilot-mcp.json +12 -0
  31. package/configs/windsurf-mcp.json +16 -0
  32. package/configs/zed-mcp.json +12 -0
  33. package/docs/ARCHITECTURE.md +877 -0
  34. package/docs/CLI-COMMANDS-REFERENCE.md +425 -0
  35. package/docs/COMPETITIVE-ANALYSIS.md +210 -0
  36. package/docs/COMPRESSION-README.md +390 -0
  37. package/docs/GRAPH-ENGINE.md +503 -0
  38. package/docs/MCP-MANUAL-SETUP.md +720 -0
  39. package/docs/MCP-TROUBLESHOOTING.md +787 -0
  40. package/docs/PATTERN-LEARNING.md +363 -0
  41. package/docs/PROFILES-GUIDE.md +453 -0
  42. package/docs/RESET-GUIDE.md +353 -0
  43. package/docs/SEARCH-ENGINE-V2.2.0.md +748 -0
  44. package/docs/SEARCH-INTEGRATION-GUIDE.md +502 -0
  45. package/docs/UI-SERVER.md +254 -0
  46. package/docs/UNIVERSAL-INTEGRATION.md +432 -0
  47. package/docs/V2.2.0-OPTIONAL-SEARCH.md +666 -0
  48. package/docs/WINDOWS-INSTALL-README.txt +34 -0
  49. package/docs/WINDOWS-POST-INSTALL.txt +45 -0
  50. package/docs/example_graph_usage.py +148 -0
  51. package/hooks/memory-list-skill.js +130 -0
  52. package/hooks/memory-profile-skill.js +284 -0
  53. package/hooks/memory-recall-skill.js +109 -0
  54. package/hooks/memory-remember-skill.js +127 -0
  55. package/hooks/memory-reset-skill.js +274 -0
  56. package/install-skills.sh +436 -0
  57. package/install.ps1 +417 -0
  58. package/install.sh +755 -0
  59. package/mcp_server.py +585 -0
  60. package/package.json +94 -0
  61. package/requirements-core.txt +24 -0
  62. package/requirements.txt +10 -0
  63. package/scripts/postinstall.js +126 -0
  64. package/scripts/preuninstall.js +57 -0
  65. package/skills/slm-build-graph/SKILL.md +423 -0
  66. package/skills/slm-list-recent/SKILL.md +348 -0
  67. package/skills/slm-recall/SKILL.md +325 -0
  68. package/skills/slm-remember/SKILL.md +194 -0
  69. package/skills/slm-status/SKILL.md +363 -0
  70. package/skills/slm-switch-profile/SKILL.md +442 -0
  71. package/src/__pycache__/cache_manager.cpython-312.pyc +0 -0
  72. package/src/__pycache__/embedding_engine.cpython-312.pyc +0 -0
  73. package/src/__pycache__/graph_engine.cpython-312.pyc +0 -0
  74. package/src/__pycache__/hnsw_index.cpython-312.pyc +0 -0
  75. package/src/__pycache__/hybrid_search.cpython-312.pyc +0 -0
  76. package/src/__pycache__/memory-profiles.cpython-312.pyc +0 -0
  77. package/src/__pycache__/memory-reset.cpython-312.pyc +0 -0
  78. package/src/__pycache__/memory_compression.cpython-312.pyc +0 -0
  79. package/src/__pycache__/memory_store_v2.cpython-312.pyc +0 -0
  80. package/src/__pycache__/migrate_v1_to_v2.cpython-312.pyc +0 -0
  81. package/src/__pycache__/pattern_learner.cpython-312.pyc +0 -0
  82. package/src/__pycache__/query_optimizer.cpython-312.pyc +0 -0
  83. package/src/__pycache__/search_engine_v2.cpython-312.pyc +0 -0
  84. package/src/__pycache__/setup_validator.cpython-312.pyc +0 -0
  85. package/src/__pycache__/tree_manager.cpython-312.pyc +0 -0
  86. package/src/cache_manager.py +520 -0
  87. package/src/embedding_engine.py +671 -0
  88. package/src/graph_engine.py +970 -0
  89. package/src/hnsw_index.py +626 -0
  90. package/src/hybrid_search.py +693 -0
  91. package/src/memory-profiles.py +518 -0
  92. package/src/memory-reset.py +485 -0
  93. package/src/memory_compression.py +999 -0
  94. package/src/memory_store_v2.py +1088 -0
  95. package/src/migrate_v1_to_v2.py +638 -0
  96. package/src/pattern_learner.py +898 -0
  97. package/src/query_optimizer.py +513 -0
  98. package/src/search_engine_v2.py +403 -0
  99. package/src/setup_validator.py +479 -0
  100. 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*