spatial-memory-mcp 1.0.3__py3-none-any.whl → 1.6.0__py3-none-any.whl

{spatial_memory_mcp-1.0.3.dist-info → spatial_memory_mcp-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spatial-memory-mcp
-Version: 1.0.3
+Version: 1.6.0
 Summary: Spatial bidirectional persistent memory MCP server for LLMs - vector-based semantic memory as a navigable landscape
 Project-URL: Homepage, https://github.com/arman-tech/spatial-memory-mcp
 Project-URL: Repository, https://github.com/arman-tech/spatial-memory-mcp
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 
 A vector-based spatial memory system that treats knowledge as a navigable landscape, not a filing cabinet.
 
-> **Project Status**: All phases complete. Production-ready with 1094 tests passing.
+> **Project Status**: All phases complete. Production-ready with 1360 tests passing.
 
 ## Supported Platforms
 
@@ -63,6 +63,42 @@ Spatial Memory MCP Server provides persistent, semantic memory for LLMs through
 - **Visual Understanding**: Generate Mermaid/SVG/JSON visualizations of your knowledge space
 - **Hybrid Search**: Combine vector similarity with full-text search
 
+## Why Spatial Memory?
+
+### Zero Cognitive Load
+**You never think about memory. Claude handles everything automatically.**
+
+- Auto-loads relevant context at session start
+- Recognizes memory-worthy moments and asks "Save this? y/n"
+- Synthesizes answers naturally—no raw JSON, no memory IDs
+- MCP instructions inject automatically—zero configuration
+
+### Cognitive Architecture, Not Storage
+Other memory systems store embeddings. Spatial Memory implements how memory actually works:
+
+- **Decay**: Memories fade over time (Ebbinghaus forgetting curve)
+- **Reinforcement**: Frequently accessed memories grow stronger
+- **Consolidation**: Similar memories merge intelligently
+- **Extraction**: Auto-capture facts, decisions, patterns from conversations
+
+### Spatial Navigation (Unique Innovation)
+Navigate knowledge like a landscape, not a filing cabinet:
+
+| Tool | What It Does |
+|------|-------------|
+| **Journey** | SLERP between two memories—discover what's conceptually in between |
+| **Wander** | Random walk exploration—find unexpected connections |
+| **Regions** | HDBSCAN clustering—see how your knowledge self-organizes |
+| **Visualize** | UMAP projection—view your memory space in 2D/3D |
+
+### 21 Tools vs. 3-6 in Competitors
+Full lifecycle management: core operations, spatial navigation, memory lifecycle, hybrid search, namespace management, data import/export, and health/stats monitoring.
+
+### Enterprise-Ready
+Connection pooling, circuit breakers, per-agent rate limiting, request tracing, response caching, and defense-in-depth security (path traversal prevention, SQL injection detection, input validation).
+
+> *See [MARKETING.md](MARKETING.md) for the complete comparison with competitors.*
+
 ## Features
 
 - **21 MCP tools** across 4 categories (core, spatial, lifecycle, utility)
@@ -72,7 +108,7 @@ Spatial Memory MCP Server provides persistent, semantic memory for LLMs through
 - **ONNX Runtime** by default for 2-3x faster embeddings
 - **Enterprise features**: Connection pooling, retry logic, batch operations
 - **Comprehensive security**: Path validation, SQL injection prevention, input sanitization
-- **1094 tests** including security edge cases
+- **1360 tests** including security edge cases
 
 ## Roadmap
 
@@ -130,6 +166,31 @@ If ONNX shows as unavailable, reinstall with:
 pip install --force-reinstall "sentence-transformers[onnx]"
 ```
 
+### Optional Performance Dependencies
+
+For best performance, install these optional dependencies:
+
+```bash
+# ONNX Runtime - 2-3x faster embeddings, 60% less memory
+pip install onnxruntime
+
+# Or install with sentence-transformers ONNX support
+pip install "sentence-transformers[onnx]"
+
+# scipy - Optimized pairwise similarity calculations
+# Used by visualize, regions, and consolidate operations
+pip install scipy
+```
+
+**Performance comparison:**
+
+| Component | Without | With | Benefit |
+|-----------|---------|------|---------|
+| ONNX Runtime | PyTorch inference | ONNX inference | 2-3x faster embeddings |
+| scipy | numpy matrix ops | scipy.cdist | Faster similarity calculations |
+
+Both are optional - the system includes fallbacks that use numpy when these aren't available.
+
 ## Configuration
 
 Copy `.env.example` to `.env` and customize:
@@ -292,6 +353,25 @@ Export all memories to parquet format
 - **Error Sanitization**: Internal errors return reference IDs, not stack traces
 - **Secure Credential Handling**: API keys stored as SecretStr
 
+## Deployment Considerations
+
+### Network Filesystems (NFS/SMB/CIFS)
+
+Spatial Memory uses file-based locking to prevent data corruption when multiple processes access the same storage. **File locking does not work reliably on network filesystems** such as NFS, SMB/CIFS, or SSHFS.
+
+If the storage path is on a network filesystem, you will see a warning at startup:
+
+```
+WARNING: Storage path appears to be on a network filesystem (nfs).
+File-based locking does not work reliably on network filesystems.
+Running multiple instances against this storage may cause data corruption.
+```
+
+**Recommendations:**
+1. **Use local storage** (default: `./.spatial-memory`) for reliable operation
+2. **Single instance only**: If you must use network storage, ensure only one MCP server instance accesses it
+3. **Acknowledge the risk**: Set `SPATIAL_MEMORY_ACKNOWLEDGE_NETWORK_FS_RISK=true` to suppress the warning
+
 ## Development
 
 ### Running Tests

spatial_memory_mcp-1.6.0.dist-info/RECORD

@@ -0,0 +1,54 @@
+spatial_memory/__init__.py,sha256=5llnvvlYGS28SmMQcE_DhSSTaFyvhh0BASb-ZHX4Z1o,2154
+spatial_memory/__main__.py,sha256=PaB4lkEBePNFCFDwjZo2mtQiWCNbK6U0fZ8jsQ9luNE,7761
+spatial_memory/config.py,sha256=SvG67Z8Hjw0XAFzVn59lLm-_Pz5dzL-c4Dli3_mtG0M,22537
+spatial_memory/factory.py,sha256=iuVKeE0q9SrDo816k2H744nELFeq7vVOdg4puHxCFOM,15806
+spatial_memory/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+spatial_memory/server.py,sha256=4a4WbS_Us0OiLfRyt5Mj3WU9rMCdMRbU6ziWajG-72I,45779
+spatial_memory/verify.py,sha256=4p4KQYRUBrKGax66n629hvb9Ul8sR2yXXnfyZLpNk-o,3939
+spatial_memory/adapters/__init__.py,sha256=xNPQCOYVsTP2ogMEcYGbxGJYH9pdksB66MZ7ctK6KbM,187
+spatial_memory/adapters/lancedb_repository.py,sha256=NwZQ-SGPTe82cFbOYtYERPRvY3eujz5iCd7EOaLiDfE,31247
+spatial_memory/core/__init__.py,sha256=wG6fws4AIF3X1vJdWA2_w2bMQo4ZXez_BYtcYvFGQvY,3033
+spatial_memory/core/cache.py,sha256=QqG0hhpaDH0mzBLIEinGP3WkKsb70QfCLMGpptguWIM,10038
+spatial_memory/core/circuit_breaker.py,sha256=zxqnOWiAnx_S7oX44UY57ihpk7V27fzW6rYgBn1BWp8,10734
+spatial_memory/core/connection_pool.py,sha256=ienTFQ-tFYwkaWD2_lcs9T8uYXL45OMpzCX5V-l_MMk,7617
+spatial_memory/core/consolidation_strategies.py,sha256=_PGdVuz4Kkf96cdIEPieGTOfubgOc6PoUYuXfJRwBd8,12805
+spatial_memory/core/database.py,sha256=3Llo2FLznQA2zUYf5r1JFnht61bPZQGTGeZ2IVhxDMI,118227
+spatial_memory/core/db_idempotency.py,sha256=B0EYdZFZYmQ7s101RviswySta7Qp7TZ2fiqWES_djyw,7978
+spatial_memory/core/db_indexes.py,sha256=p1glBuna81yY8bu8hhJkR6AhuzeZgaAaeKnsd3Oe4No,20115
+spatial_memory/core/db_migrations.py,sha256=x-_dXZrtfZZQwb4d3ZW32zw1-CzbDLC7Y33fdsvQM5Y,19138
+spatial_memory/core/db_search.py,sha256=XnNpqI2oto9EKbmp7bYBxeaxGfblJicR9KazvZKfhbg,19866
+spatial_memory/core/db_versioning.py,sha256=7LGWQO6EiwIgw-C5e81xG4jEO34b5y95Ag6uoVrU7Xw,5984
+spatial_memory/core/embeddings.py,sha256=g_C8rmrNH8qTroPcg-aYJo5Z6NR_YqGN050Iryytx5c,20892
+spatial_memory/core/errors.py,sha256=mGQlPNNiNOdErYPXdEQXM1_-IeueUB_jtgdt8P8lzUQ,8799
+spatial_memory/core/file_security.py,sha256=kHIYEnZIRFz94FxCJ7oOHiaihgQRB1rsOHHmJprHNhU,25766
+spatial_memory/core/filesystem.py,sha256=aE8BvM8tyIMbjtaiyG0Si0F1c85jxAwa3IM5I_kvkME,5602
+spatial_memory/core/health.py,sha256=Xq9TYfmBN3YLjYOrpFWtvbR1-fQbSrP1oorSVjRHOSg,9145
+spatial_memory/core/helpers.py,sha256=nxLXGfkpydWzEgMj8PkdX9gVvybN2aCH-CfbEkq6U_w,1931
+spatial_memory/core/import_security.py,sha256=DiG0BsX65JGGf6B1T855SVz1TZB1ViI3JXRi1uW03sQ,13296
+spatial_memory/core/lifecycle_ops.py,sha256=P8jc4JGBF39ayNikgLu0I3kGcJ3ph0VsvAHSxjp35FI,35836
+spatial_memory/core/logging.py,sha256=JfFRzHmhZ2BPNSJiKIHGjfUeskFVo8Bj7nOKznvv0kU,6542
+spatial_memory/core/metrics.py,sha256=8B26sAd2y6xrpaJr8mNgOAMzAZDd1uXOvAGxz_1nhfY,5383
+spatial_memory/core/models.py,sha256=VX61h5_pnsIQ5w5LjpElhVTW4UAa0RKadnrtLLOQb94,17353
+spatial_memory/core/rate_limiter.py,sha256=5A3YI6C0_YrWZeSBBxF7Eu5HUD8rodS45301730doF0,10582
+spatial_memory/core/response_types.py,sha256=VhfQLpTxgdJf3CYPtQALvh4KmaUbHzVAT_qtRVtoQgs,10603
+spatial_memory/core/security.py,sha256=fjIYqsyzK4qqm7sI8FNEE2xx9WjNJnrAslOBLVRVwgs,19759
+spatial_memory/core/spatial_ops.py,sha256=_xNrZzrbL7w2uAMJkQZEtTMjERQpo04cuSUoTNebiew,13360
+spatial_memory/core/tracing.py,sha256=9O3WdUJfCl2sohYWlaQETrCO7_P_N3qY_MqSAnpQPl0,8438
+spatial_memory/core/utils.py,sha256=YvvU3EbbAicR732LkHMM5-u4wvBaJ4G9DigBaB2CoI4,3438
+spatial_memory/core/validation.py,sha256=A8a5PF7X8Veg8S176UFEqkZDBlWILbQM-5wtAMOgG3U,13476
+spatial_memory/migrations/__init__.py,sha256=wljoV_u2PPx-dH6JOPmjEP5xEbwoM9HQ1WYDZr7PW58,1072
+spatial_memory/ports/__init__.py,sha256=Lq9ht9AS4VwPbMojtd_FYkA7lUuCXmYHwv6sweJi9AQ,243
+spatial_memory/ports/repositories.py,sha256=oJMU7UHoj4YudyeOQaSkI9A2z81L3Vn2q7hm3RILfXI,19920
+spatial_memory/services/__init__.py,sha256=epaF3aHxK2sgGVMp6rS_fxMMAvDVPxjaWm1n4hKOMWU,1564
+spatial_memory/services/export_import.py,sha256=2vZnFvX1deV-Zdj0HGkc2My8Oy1BrFJL8Peep25iUKI,38190
+spatial_memory/services/lifecycle.py,sha256=asxFBp06qfnaZJpAph6Dm6i7kN1cREXuoopkjuOMvwc,42937
+spatial_memory/services/memory.py,sha256=MZ9NMNXBRYEA39vzT5gAB7PXJrGFwC-D98SLZe7Z50Q,12944
+spatial_memory/services/spatial.py,sha256=3UMPm4mRQ42oXNwLUEYp4SAinnGX4dwOnWaK9CkVViA,42552
+spatial_memory/services/utility.py,sha256=89rn1gNJwNQIhrWjmVS3RKP5AQuCvjswFeefMp7yK-4,14950
+spatial_memory/tools/__init__.py,sha256=ZhFZp5j8HA4Qx5pVcRmgTcBbqY3X5TmgMNpSkyAMqJA,127
+spatial_memory/tools/definitions.py,sha256=Ueg_BrRGJcp_jnQD95DiYFPkxU419XPkbjzQFDG3jtY,25397
+spatial_memory_mcp-1.6.0.dist-info/METADATA,sha256=SKMn9h_8wYhMK45Vh5iqkH8-HSyjaf5r96Fkyv0tBek,15438
+spatial_memory_mcp-1.6.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+spatial_memory_mcp-1.6.0.dist-info/entry_points.txt,sha256=nJ4RJBB9SvhNktJdikcAS27fSwtKekpgPR4GTy2r1cE,64
+spatial_memory_mcp-1.6.0.dist-info/licenses/LICENSE,sha256=g65vrroU3yJxekbYV8xmDj7KFrXAg89eCM8vcWrpKmU,1095
+spatial_memory_mcp-1.6.0.dist-info/RECORD,,

spatial_memory_mcp-1.0.3.dist-info/RECORD

@@ -1,41 +0,0 @@
-spatial_memory/__init__.py,sha256=lSPxVgNQDW7w4nPi0Oq7Sh5CkOKc0MYjxnyD9DH3oc0,2057
-spatial_memory/__main__.py,sha256=bhoAnPQkuD-jAHavxQEbv3JxpsbWB9qvWlYEWk0_TWQ,288
-spatial_memory/config.py,sha256=MC43JW6qjjiQ82CPscYxBXTH3ntN4Qpk9yYupXq7DDc,18434
-spatial_memory/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-spatial_memory/server.py,sha256=TcDeIVEW9UoMPBrdlbI_HIQm61J3H6c_DyfYGH7Q7aE,41506
-spatial_memory/verify.py,sha256=4p4KQYRUBrKGax66n629hvb9Ul8sR2yXXnfyZLpNk-o,3939
-spatial_memory/adapters/__init__.py,sha256=xNPQCOYVsTP2ogMEcYGbxGJYH9pdksB66MZ7ctK6KbM,187
-spatial_memory/adapters/lancedb_repository.py,sha256=nFC3I_biNFMC546hoJLnqbTCgk5LSlyfnz3QDC77fX8,28430
-spatial_memory/core/__init__.py,sha256=lLnEqUbI32ujmyeuYUXgof_k1suLjhmMRVNM5UOvm-4,2058
-spatial_memory/core/connection_pool.py,sha256=-mD8nvgiKpVlycMw24FNaEh3E1XA4hXNkaaQW023I40,6083
-spatial_memory/core/database.py,sha256=rZ48npMsnvVXvkxmAe_55qLwKITJgzkLfc6qJYYwEpc,115985
-spatial_memory/core/embeddings.py,sha256=tM88EpxE_DhC1uoJxBAIYYw1ZYzIbn3hnL0opzBDz5A,14759
-spatial_memory/core/errors.py,sha256=yqLt9KqE5iEBvKha1wZWNtN_QaVYcX9YPpiRmeIN11A,6551
-spatial_memory/core/file_security.py,sha256=kHIYEnZIRFz94FxCJ7oOHiaihgQRB1rsOHHmJprHNhU,25766
-spatial_memory/core/health.py,sha256=Xq9TYfmBN3YLjYOrpFWtvbR1-fQbSrP1oorSVjRHOSg,9145
-spatial_memory/core/helpers.py,sha256=nxLXGfkpydWzEgMj8PkdX9gVvybN2aCH-CfbEkq6U_w,1931
-spatial_memory/core/import_security.py,sha256=DiG0BsX65JGGf6B1T855SVz1TZB1ViI3JXRi1uW03sQ,13296
-spatial_memory/core/lifecycle_ops.py,sha256=P8jc4JGBF39ayNikgLu0I3kGcJ3ph0VsvAHSxjp35FI,35836
-spatial_memory/core/logging.py,sha256=5WTPRm7s-aIxISfN40eEOR3821fP5DyDlZwRwrcI1cA,3102
-spatial_memory/core/metrics.py,sha256=8B26sAd2y6xrpaJr8mNgOAMzAZDd1uXOvAGxz_1nhfY,5383
-spatial_memory/core/models.py,sha256=QU3fryNMucHMV8Cbd-jiCU0ofrAK525QNerVk_Zb1oo,17190
-spatial_memory/core/rate_limiter.py,sha256=avtZeA65W33NF99RtY_rIMD9_UzgMiFaqXsIA-7HvQ8,3172
-spatial_memory/core/security.py,sha256=fjIYqsyzK4qqm7sI8FNEE2xx9WjNJnrAslOBLVRVwgs,19759
-spatial_memory/core/spatial_ops.py,sha256=_xNrZzrbL7w2uAMJkQZEtTMjERQpo04cuSUoTNebiew,13360
-spatial_memory/core/utils.py,sha256=YvvU3EbbAicR732LkHMM5-u4wvBaJ4G9DigBaB2CoI4,3438
-spatial_memory/core/validation.py,sha256=xMEMRNV0je3MpsHLzXGBHDuO5pZwKIH3pNu57gCkyNs,9679
-spatial_memory/ports/__init__.py,sha256=Lq9ht9AS4VwPbMojtd_FYkA7lUuCXmYHwv6sweJi9AQ,243
-spatial_memory/ports/repositories.py,sha256=_54TvFw5OIQ6ED8mNSC-7m2jOKVlyrFsuGDefhEADok,18081
-spatial_memory/services/__init__.py,sha256=epaF3aHxK2sgGVMp6rS_fxMMAvDVPxjaWm1n4hKOMWU,1564
-spatial_memory/services/export_import.py,sha256=ihPmObVOS86dbo0q_vIUMqlXFZOX6dth8pulnbK2dVM,37639
-spatial_memory/services/lifecycle.py,sha256=bWGHdAjueU1dE16YmHO2BPsizxej8_RupdnjhiJuItg,32681
-spatial_memory/services/memory.py,sha256=-NSDWc9fp_h-wdYyaErkie0M31JmWj9IXoFWH0D_l7E,9775
-spatial_memory/services/spatial.py,sha256=7cnZbZbHHx3lhvSv_l6gEUCcx-drq6Q3XGtD5_oi0dc,38668
-spatial_memory/services/utility.py,sha256=89rn1gNJwNQIhrWjmVS3RKP5AQuCvjswFeefMp7yK-4,14950
-spatial_memory/tools/__init__.py,sha256=ZhFZp5j8HA4Qx5pVcRmgTcBbqY3X5TmgMNpSkyAMqJA,127
-spatial_memory/tools/definitions.py,sha256=zrs9o_9W76ZM0dORUegqkxOuw9lT3mujXy-bulPKFxY,23544
-spatial_memory_mcp-1.0.3.dist-info/METADATA,sha256=BhZ2cvsiNuajdvAGc9O_Sw0a6sUqLtFbB99w15Fg69E,12035
-spatial_memory_mcp-1.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-spatial_memory_mcp-1.0.3.dist-info/entry_points.txt,sha256=nJ4RJBB9SvhNktJdikcAS27fSwtKekpgPR4GTy2r1cE,64
-spatial_memory_mcp-1.0.3.dist-info/licenses/LICENSE,sha256=g65vrroU3yJxekbYV8xmDj7KFrXAg89eCM8vcWrpKmU,1095
-spatial_memory_mcp-1.0.3.dist-info/RECORD,,