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

spatial_memory/__init__.py

@@ -1,6 +1,6 @@
 """Spatial Memory MCP Server - Vector-based semantic memory for LLMs."""
 
-__version__ = "1.6.0"
+__version__ = "1.6.2"
 __author__ = "arman-tech"
 
 # Re-export core components for convenience

spatial_memory/__main__.py

@@ -44,7 +44,7 @@ def run_migrate(args: argparse.Namespace) -> int:
         format="%(levelname)s: %(message)s",
     )
 
-    print(f"Spatial Memory Migration Tool")
+    print("Spatial Memory Migration Tool")
     print(f"Target schema version: {CURRENT_SCHEMA_VERSION}")
     print(f"Database path: {settings.memory_path}")
     print()
@@ -109,7 +109,7 @@ def run_migrate(args: argparse.Namespace) -> int:
                 return 1
 
             if result.migrations_applied:
-                print(f"\nRolled back migrations:")
+                print("\nRolled back migrations:")
                 for v in result.migrations_applied:
                     print(f"  - {v}")
                 print(f"\nCurrent version: {result.current_version}")
@@ -177,6 +177,14 @@ def run_version() -> None:
     print(f"spatial-memory {__version__}")
 
 
+def run_instructions() -> None:
+    """Print the MCP server instructions that are auto-injected into Claude's context."""
+    from spatial_memory.server import SpatialMemoryServer
+
+    instructions = SpatialMemoryServer._get_server_instructions()
+    print(instructions)
+
+
 def main() -> NoReturn:
     """Main entry point with subcommand support."""
     parser = argparse.ArgumentParser(
@@ -196,11 +204,17 @@ def main() -> NoReturn:
     )
 
     # Server command (default)
-    server_parser = subparsers.add_parser(
+    subparsers.add_parser(
         "serve",
         help="Start the MCP server (default if no command given)",
     )
 
+    # Instructions command
+    subparsers.add_parser(
+        "instructions",
+        help="Show the MCP instructions injected into Claude's context",
+    )
+
     # Migrate command
     migrate_parser = subparsers.add_parser(
         "migrate",
@@ -238,7 +252,10 @@ def main() -> NoReturn:
         run_version()
         sys.exit(0)
 
-    if args.command == "migrate":
+    if args.command == "instructions":
+        run_instructions()
+        sys.exit(0)
+    elif args.command == "migrate":
         sys.exit(run_migrate(args))
     elif args.command == "serve" or args.command is None:
         # Default to running the server

spatial_memory/config.py

@@ -47,7 +47,7 @@ class Settings(BaseSettings):
     )
     embedding_backend: str = Field(
         default="auto",
-        description="Embedding backend: 'auto' (ONNX if available, else PyTorch), 'onnx', or 'pytorch'",
+        description="Embedding backend: 'auto', 'onnx', or 'pytorch'",
     )
 
     # OpenAI (optional)

spatial_memory/core/__init__.py

@@ -11,7 +11,6 @@ from spatial_memory.core.db_indexes import IndexManager
 from spatial_memory.core.db_search import SearchManager
 from spatial_memory.core.db_versioning import VersionManager
 from spatial_memory.core.embeddings import EmbeddingService
-from spatial_memory.core.rate_limiter import RateLimiter
 from spatial_memory.core.errors import (
     ClusteringError,
     ConfigurationError,
@@ -45,7 +44,7 @@ from spatial_memory.core.models import (
     VisualizationEdge,
     VisualizationNode,
 )
-from spatial_memory.core.utils import to_aware_utc, to_naive_utc, utc_now, utc_now_naive
+from spatial_memory.core.rate_limiter import RateLimiter
 from spatial_memory.core.tracing import (
     RequestContext,
     TimingContext,
@@ -55,6 +54,7 @@ from spatial_memory.core.tracing import (
     request_context,
     set_context,
 )
+from spatial_memory.core.utils import to_aware_utc, to_naive_utc, utc_now, utc_now_naive
 
 __all__ = [
     # Errors - Base

spatial_memory/core/consolidation_strategies.py

@@ -26,7 +26,6 @@ from spatial_memory.core.lifecycle_ops import (
 from spatial_memory.core.models import Memory, MemorySource
 
 if TYPE_CHECKING:
-    import numpy as np
 
     from spatial_memory.ports.repositories import (
         EmbeddingServiceProtocol,

spatial_memory/core/database.py

@@ -14,7 +14,6 @@ from __future__ import annotations
 
 import json
 import logging
-import math
 import threading
 import time
 import uuid
@@ -30,8 +29,8 @@ import lancedb.index
 import numpy as np
 import pyarrow as pa
 import pyarrow.parquet as pq
-
-from filelock import FileLock, Timeout as FileLockTimeout
+from filelock import FileLock
+from filelock import Timeout as FileLockTimeout
 
 from spatial_memory.core.connection_pool import ConnectionPool
 from spatial_memory.core.db_idempotency import IdempotencyManager, IdempotencyRecord
@@ -47,8 +46,12 @@ from spatial_memory.core.errors import (
     StorageError,
     ValidationError,
 )
-from spatial_memory.core.filesystem import detect_filesystem_type, get_filesystem_warning_message, is_network_filesystem
-from spatial_memory.core.utils import to_aware_utc, utc_now
+from spatial_memory.core.filesystem import (
+    detect_filesystem_type,
+    get_filesystem_warning_message,
+    is_network_filesystem,
+)
+from spatial_memory.core.utils import utc_now
 
 # Import centralized validation functions
 from spatial_memory.core.validation import (
@@ -221,7 +224,7 @@ def with_write_lock(func: F) -> F:
     Uses RLock to allow nested calls (e.g., bulk_import -> insert_batch).
     """
     @wraps(func)
-    def wrapper(self: "Database", *args: Any, **kwargs: Any) -> Any:
+    def wrapper(self: Database, *args: Any, **kwargs: Any) -> Any:
         with self._write_lock:
             return func(self, *args, **kwargs)
     return cast(F, wrapper)
@@ -235,7 +238,7 @@ def with_stale_connection_recovery(func: F) -> F:
     reconnects, and retries the operation once.
     """
     @wraps(func)
-    def wrapper(self: "Database", *args: Any, **kwargs: Any) -> Any:
+    def wrapper(self: Database, *args: Any, **kwargs: Any) -> Any:
         try:
             return func(self, *args, **kwargs)
         except Exception as e:
@@ -372,7 +375,7 @@ class ProcessLockManager:
             self._set_depth(depth - 1)
             return False  # Still holding
 
-    def __enter__(self) -> "ProcessLockManager":
+    def __enter__(self) -> ProcessLockManager:
         """Enter context manager - acquire lock."""
         self.acquire()
         return self
@@ -397,7 +400,7 @@ def with_process_lock(func: F) -> F:
             ...
     """
     @wraps(func)
-    def wrapper(self: "Database", *args: Any, **kwargs: Any) -> Any:
+    def wrapper(self: Database, *args: Any, **kwargs: Any) -> Any:
         if self._process_lock is None:
             return func(self, *args, **kwargs)
         with self._process_lock:
@@ -1705,7 +1708,7 @@ class Database:
         old_namespace = _validate_namespace(old_namespace)
         new_namespace = _validate_namespace(new_namespace)
         safe_old = _sanitize_string(old_namespace)
-        safe_new = _sanitize_string(new_namespace)
+        _sanitize_string(new_namespace)  # Validate but don't store unused result
 
         try:
             # Check if source namespace exists
@@ -1835,7 +1838,7 @@ class Database:
             if not memory_ids:
                 return None
 
-            safe_namespace = _sanitize_string(target_namespace)
+            _sanitize_string(target_namespace)  # Validate namespace
             now = utc_now()
 
             # Process in batches for large rollbacks

spatial_memory/core/db_indexes.py

@@ -380,7 +380,8 @@ class IndexManager:
             index_type = "IVF_FLAT"
             sample_rate = max(16, count // 4)  # Lower sample rate for small data
         else:
-            index_type = self._db.index_type if self._db.index_type in ("IVF_PQ", "IVF_FLAT") else "IVF_PQ"
+            valid_types = ("IVF_PQ", "IVF_FLAT")
+            index_type = self._db.index_type if self._db.index_type in valid_types else "IVF_PQ"
 
         # Ensure num_partitions < num_vectors for KMeans clustering
         if num_partitions >= count:

spatial_memory/core/db_migrations.py

@@ -24,7 +24,6 @@ Usage:
 
 from __future__ import annotations
 
-import json
 import logging
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field

spatial_memory/core/db_search.py

@@ -18,6 +18,8 @@ import numpy as np
 from spatial_memory.core.errors import StorageError, ValidationError
 from spatial_memory.core.validation import (
     sanitize_string as _sanitize_string,
+)
+from spatial_memory.core.validation import (
     validate_namespace as _validate_namespace,
 )
 
@@ -312,7 +314,8 @@ class SearchManager:
                 ])
 
             # Execute search and get results
-            # LanceDB returns results with _query_index to identify which query each result belongs to
+            # LanceDB returns results with _query_index to identify which query
+            # each result belongs to
             search = search.limit(limit_per_query)
             results_df = search.to_pandas()
 

spatial_memory/core/embeddings.py

@@ -265,13 +265,13 @@ class EmbeddingService:
                     backend="onnx",
                 )
                 logger.info(
-                    f"Using ONNX Runtime backend (2-3x faster inference)"
+                    "Using ONNX Runtime backend (2-3x faster inference)"
                 )
             else:
                 # Use default PyTorch backend
                 self._model = SentenceTransformer(self.model_name)
                 logger.info(
-                    f"Using PyTorch backend"
+                    "Using PyTorch backend"
                 )
 
             self._dimensions = self._model.get_sentence_embedding_dimension()

spatial_memory/core/file_security.py

@@ -23,7 +23,6 @@ import re
 import stat
 import urllib.parse
 from collections.abc import Sequence
-from io import BufferedReader
 from pathlib import Path
 from typing import BinaryIO
 

spatial_memory/core/response_types.py

@@ -13,7 +13,6 @@ from __future__ import annotations
 
 from typing import Any, TypedDict
 
-
 # =============================================================================
 # Nested TypedDicts (shared across multiple responses)
 # =============================================================================

spatial_memory/ports/repositories.py

@@ -12,7 +12,6 @@ from typing import Any, Protocol
 
 import numpy as np
 
-from spatial_memory.core.errors import NamespaceNotFoundError
 from spatial_memory.core.models import Memory, MemoryResult
 
 

spatial_memory/server.py

@@ -25,7 +25,6 @@ from mcp.types import TextContent, Tool
 
 from spatial_memory import __version__
 from spatial_memory.config import ConfigurationError, get_settings, validate_startup
-from spatial_memory.factory import ServiceFactory
 from spatial_memory.core.database import (
     clear_connection_cache,
     set_connection_pool_max_size,
@@ -46,6 +45,10 @@ from spatial_memory.core.errors import (
     SpatialMemoryError,
     ValidationError,
 )
+from spatial_memory.core.health import HealthChecker
+from spatial_memory.core.logging import configure_logging
+from spatial_memory.core.metrics import is_available as metrics_available
+from spatial_memory.core.metrics import record_request
 from spatial_memory.core.response_types import (
     ConsolidateResponse,
     DecayResponse,
@@ -71,15 +74,12 @@ from spatial_memory.core.response_types import (
     VisualizeResponse,
     WanderResponse,
 )
-from spatial_memory.core.health import HealthChecker
-from spatial_memory.core.logging import configure_logging
-from spatial_memory.core.metrics import is_available as metrics_available
-from spatial_memory.core.metrics import record_request
 from spatial_memory.core.tracing import (
     RequestContext,
     TimingContext,
     request_context,
 )
+from spatial_memory.factory import ServiceFactory
 from spatial_memory.tools import TOOLS
 
 if TYPE_CHECKING:
@@ -999,10 +999,12 @@ class SpatialMemoryServer:
         """
         return '''## Spatial Memory System
 
-You have access to a persistent semantic memory system. Use it proactively to build cumulative knowledge across sessions.
+You have access to a persistent semantic memory system. Use it proactively to
+build cumulative knowledge across sessions.
 
 ### Session Start
-At conversation start, call `recall` with the user's apparent task/context to load relevant memories. Present insights naturally:
+At conversation start, call `recall` with the user's apparent task/context to
+load relevant memories. Present insights naturally:
 - Good: "Based on previous work, you decided to use PostgreSQL because..."
 - Bad: "The database returned: [{id: '...', content: '...'}]"
 
@@ -1013,11 +1015,13 @@ After these events, ask briefly "Save this? y/n" (minimal friction):
 - **Patterns**: "This pattern works...", "The trick is...", "Always do X when..."
 - **Discoveries**: "I found that...", "Important:...", "TIL..."
 
-Do NOT ask for trivial information. Only prompt for insights that would help future sessions.
+Do NOT ask for trivial information. Only prompt for insights that would help
+future sessions.
 
 ### Saving Memories
 When user confirms, save with:
-- **Detailed content**: Include full context, reasoning, and specifics. Future agents need complete information.
+- **Detailed content**: Include full context, reasoning, and specifics. Future
+  agents need complete information.
 - **Contextual namespace**: Use project name, or categories like "decisions", "errors", "patterns"
 - **Descriptive tags**: Technologies, concepts, error types involved
 - **High importance (0.8-1.0)**: For decisions and critical fixes

spatial_memory/services/__init__.py

@@ -7,6 +7,9 @@ from spatial_memory.core.errors import (
     NamespaceOperationError,
     ReinforcementError,
 )
+from spatial_memory.services.export_import import (
+    ExportImportService,
+)
 from spatial_memory.services.lifecycle import (
     ConsolidateResult,
     ConsolidationGroupResult,
@@ -33,9 +36,6 @@ from spatial_memory.services.spatial import (
 from spatial_memory.services.utility import (
     UtilityService,
 )
-from spatial_memory.services.export_import import (
-    ExportImportService,
-)
 
 __all__ = [
     # Lifecycle

spatial_memory/services/export_import.py

@@ -17,11 +17,11 @@ import csv
 import json
 import logging
 import time
-from collections.abc import Sequence
-from datetime import datetime, timezone
-from pathlib import Path
+from collections.abc import Iterator, Sequence
+from datetime import datetime
 from io import TextIOWrapper
-from typing import TYPE_CHECKING, Any, BinaryIO, Iterator
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, BinaryIO
 
 import numpy as np
 
@@ -45,6 +45,8 @@ from spatial_memory.core.models import (
 logger = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
+    import pyarrow as pa
+
     from spatial_memory.ports.repositories import (
         EmbeddingServiceProtocol,
         MemoryRepositoryProtocol,
@@ -504,7 +506,7 @@ class ExportImportService:
     # Export Format Handlers
     # =========================================================================
 
-    def _create_parquet_schema(self, include_vectors: bool) -> "pa.Schema":
+    def _create_parquet_schema(self, include_vectors: bool) -> pa.Schema:
         """Create PyArrow schema for Parquet export.
 
         Args:
@@ -816,8 +818,7 @@ class ExportImportService:
         if content.startswith("["):
             # JSON array
             records = json.loads(content)
-            for record in records:
-                yield record
+            yield from records
         else:
             # JSON Lines (one object per line)
             for line in content.split("\n"):
@@ -959,7 +960,8 @@ class ExportImportService:
                                 ImportValidationError(
                                     row_number=row_number,
                                     field="vector",
-                                    error=f"Vector dimension mismatch: expected {expected_dims}, got {actual_dims}",
+                                    error=f"Vector dimension mismatch: expected "
+                                    f"{expected_dims}, got {actual_dims}",
                                     value=f"[{actual_dims} dimensions]",
                                 )
                             )

spatial_memory/services/lifecycle.py

@@ -20,6 +20,10 @@ from typing import TYPE_CHECKING, Any, Literal
 
 import numpy as np
 
+from spatial_memory.core.consolidation_strategies import (
+    ConsolidationAction,
+    get_strategy,
+)
 from spatial_memory.core.errors import (
     ConsolidationError,
     DecayError,
@@ -27,10 +31,6 @@ from spatial_memory.core.errors import (
     ReinforcementError,
     ValidationError,
 )
-from spatial_memory.core.consolidation_strategies import (
-    ConsolidationAction,
-    get_strategy,
-)
 from spatial_memory.core.lifecycle_ops import (
     apply_decay,
     calculate_decay_factor,
@@ -52,11 +52,11 @@ from spatial_memory.core.models import (
     ReinforcedMemory,
     ReinforceResult,
 )
+from spatial_memory.core.utils import to_naive_utc, utc_now, utc_now_naive
+from spatial_memory.core.validation import validate_namespace
 
 # Alias for backward compatibility
 ConsolidationGroupResult = ConsolidationGroup
-from spatial_memory.core.utils import to_naive_utc, utc_now, utc_now_naive
-from spatial_memory.core.validation import validate_namespace
 
 logger = logging.getLogger(__name__)
 
@@ -384,7 +384,8 @@ class LifecycleService:
             # Calculate reinforcement for all found memories
             now = utc_now()
             batch_updates: list[tuple[str, dict[str, Any]]] = []
-            reinforcement_info: list[tuple[str, Memory, float, float]] = []  # id, memory, new_imp, boost
+            # Tuple: (id, memory, new_importance, boost_applied)
+            reinforcement_info: list[tuple[str, Memory, float, float]] = []
 
             for memory_id, memory in memory_map.items():
                 # Calculate new importance
@@ -413,7 +414,9 @@ class LifecycleService:
                     f"{len(batch_failed_ids)} failed"
                 )
             except Exception as e:
-                logger.warning(f"Batch reinforce update failed: {e}, falling back to individual updates")
+                logger.warning(
+                    f"Batch reinforce update failed: {e}, falling back to individual updates"
+                )
                 # Fall back to individual updates on batch failure
                 batch_failed_ids = []
                 for memory_id, updates in batch_updates:

spatial_memory/services/spatial.py

@@ -267,8 +267,11 @@ class SpatialService:
                     steps_with_memories += 1
 
                 # Use 0.0 if no memories found (inf means no distance calculated)
-                # Clamp to 0.0 to handle floating point precision errors (e.g., -4.89e-08)
-                final_distance = 0.0 if distance_to_path == float("inf") else max(0.0, distance_to_path)
+                # Clamp to 0.0 to handle floating point precision errors
+                if distance_to_path == float("inf"):
+                    final_distance = 0.0
+                else:
+                    final_distance = max(0.0, distance_to_path)
                 journey_steps.append(
                     JourneyStep(
                         step=step_num,

spatial_memory/services/utility.py

@@ -243,7 +243,8 @@ class UtilityService:
                     namespace=namespace,
                     memories_deleted=memory_count,
                     success=True,
-                    message=f"DRY RUN: Would delete {memory_count} memories from namespace '{namespace}'",
+                    message=f"DRY RUN: Would delete {memory_count} memories "
+                    f"from namespace '{namespace}'",
                     dry_run=True,
                 )
 
@@ -261,7 +262,7 @@ class UtilityService:
                 namespace=namespace,
                 memories_deleted=deleted_count,
                 success=True,
-                message=f"Successfully deleted {deleted_count} memories from namespace '{namespace}'",
+                message=f"Deleted {deleted_count} memories from namespace '{namespace}'",
                 dry_run=False,
             )
 
@@ -313,7 +314,8 @@ class UtilityService:
                 new_namespace=new_namespace,
                 memories_renamed=renamed_count,
                 success=True,
-                message=f"Successfully renamed {renamed_count} memories from '{old_namespace}' to '{new_namespace}'",
+                message=f"Renamed {renamed_count} memories "
+                f"from '{old_namespace}' to '{new_namespace}'",
             )
 
         except NamespaceNotFoundError:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spatial-memory-mcp
-Version: 1.6.0
+Version: 1.6.2
 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
@@ -42,9 +42,13 @@ Description-Content-Type: text/markdown
 
 # Spatial Memory MCP Server
 
+[![PyPI version](https://badge.fury.io/py/spatial-memory-mcp.svg)](https://pypi.org/project/spatial-memory-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 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 1360 tests passing.
+> **Version 1.6.2** — Production-ready with 1,360 tests passing.
 
 ## Supported Platforms
 
@@ -91,7 +95,7 @@ Navigate knowledge like a landscape, not a filing cabinet:
 | **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
+### 22 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
@@ -101,7 +105,7 @@ Connection pooling, circuit breakers, per-agent rate limiting, request tracing,
 
 ## Features
 
-- **21 MCP tools** across 4 categories (core, spatial, lifecycle, utility)
+- **22 MCP tools** across 4 categories (core, spatial, lifecycle, utility)
 - **Clean Architecture** with ports/adapters pattern for testability
 - **LanceDB** vector storage with automatic indexing
 - **Dual embedding support**: Local (sentence-transformers) or OpenAI API
@@ -119,10 +123,19 @@ Connection pooling, circuit breakers, per-agent rate limiting, request tracing,
 | Phase 3: Spatial Operations | Complete | `journey`, `wander`, `regions`, `visualize` |
 | Phase 4: Lifecycle Operations | Complete | `consolidate`, `extract`, `decay`, `reinforce` |
 | Phase 5: Utilities | Complete | `stats`, `namespaces`, `export`, `import`, `hybrid_recall` |
-| Phase 6: Polish & Release | In Progress | PyPI release pending |
+| Phase 6: Polish & Release | Complete | v1.6.0 on PyPI |
 
 ## Installation
 
+### From PyPI (Recommended)
+
+```bash
+pip install spatial-memory-mcp
+
+# Or with uv
+uv pip install spatial-memory-mcp
+```
+
 ### Development Setup
 
 ```bash
@@ -134,6 +147,10 @@ pip install -e ".[dev]"
 ### With OpenAI Support
 
 ```bash
+# From PyPI
+pip install spatial-memory-mcp[openai]
+
+# From source
 pip install -e ".[dev,openai]"
 ```
 
@@ -166,6 +183,28 @@ If ONNX shows as unavailable, reinstall with:
 pip install --force-reinstall "sentence-transformers[onnx]"
 ```
 
+### CLI Commands
+
+The `spatial-memory` CLI provides several commands:
+
+```bash
+# Start the MCP server (default)
+spatial-memory serve
+
+# View the MCP instructions injected into Claude's context
+spatial-memory instructions
+
+# Run database migrations
+spatial-memory migrate --status    # Check migration status
+spatial-memory migrate --dry-run   # Preview migrations
+spatial-memory migrate             # Apply pending migrations
+
+# Show version
+spatial-memory --version
+```
+
+The `instructions` command is useful for understanding what behavioral guidelines are automatically injected when the MCP server connects to Claude.
+
 ### Optional Performance Dependencies
 
 For best performance, install these optional dependencies:
@@ -257,7 +296,7 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
 }
 ```
 
-## Available Tools (21 Total)
+## Available Tools (22 Total)
 
 For complete API documentation including parameters, return types, and examples, see [docs/API.md](docs/API.md).
 
@@ -301,6 +340,7 @@ For complete API documentation including parameters, return types, and examples,
 | `export_memories` | Export memories to Parquet, JSON, or CSV format |
 | `import_memories` | Import memories from exported files with validation |
 | `hybrid_recall` | Combined vector + full-text search with configurable weighting |
+| `health` | Check system health status |
 
 ## Tool Examples
 
@@ -348,7 +388,7 @@ Export all memories to parquet format
 
 - **Path Traversal Prevention**: All file operations validate paths against allowed directories
 - **Symlink Attack Protection**: Optional symlink blocking for sensitive environments
-- **SQL Injection Prevention**: 15+ dangerous patterns detected and blocked
+- **SQL Injection Prevention**: 13 patterns covering major attack vectors
 - **Input Validation**: Pydantic models validate all inputs
 - **Error Sanitization**: Internal errors return reference IDs, not stack traces
 - **Secure Credential Handling**: API keys stored as SecretStr
@@ -418,7 +458,7 @@ See [SPATIAL-MEMORY-ARCHITECTURE-DIAGRAMS.md](SPATIAL-MEMORY-ARCHITECTURE-DIAGRA
 
 | Document | Description |
 |----------|-------------|
-| [docs/API.md](docs/API.md) | Complete API reference for all 21 tools |
+| [docs/API.md](docs/API.md) | Complete API reference for all 22 tools |
 | [docs/BENCHMARKS.md](docs/BENCHMARKS.md) | Performance benchmarks and test results |
 | [docs/METRICS.md](docs/METRICS.md) | Prometheus metrics documentation |
 | [docs/troubleshooting.md](docs/troubleshooting.md) | Troubleshooting guide |
@@ -450,7 +490,9 @@ For security vulnerabilities, please email directly rather than opening a public
 
 ## For Claude Code Users
 
-This project includes [CLAUDE.md](CLAUDE.md) with instructions for the Claude Code AI assistant to interact with the memory system.
+When the MCP server connects, behavioral instructions are **automatically injected** into Claude's context—no configuration needed. Run `spatial-memory instructions` to view what gets injected.
+
+For contributors working on this codebase, [CLAUDE.md](CLAUDE.md) provides project-specific guidance for AI assistants.
 
 ## License
 

{spatial_memory_mcp-1.6.0.dist-info → spatial_memory_mcp-1.6.2.dist-info}/RECORD

@@ -1,26 +1,26 @@
-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/__init__.py,sha256=TjqwnyL1ZN23Q483OYIlPWXq-FcPmShuLQ9J4xPIyJs,2154
+spatial_memory/__main__.py,sha256=1WK2evonr4Sv1wZNbBuQHQ_z14Aa9kJr2w3GwDlz04I,8279
+spatial_memory/config.py,sha256=2vUUi39QnLSglEnkOVp748OIwTltTXa0C6HGf55_LNQ,22503
 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/server.py,sha256=PduECYXoMRpXLHATPyT_uJxpq5LszI6g-GBLYBC1hC8,45785
 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/__init__.py,sha256=MWU1dWaE-8opHiNgTgn8Jd1MhCWfRTSbrHwlzR6lgkk,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/consolidation_strategies.py,sha256=u-s5uGrx9RpwJkkoU6gWFASCWrhWneAh9UVXXPMZHjw,12782
+spatial_memory/core/database.py,sha256=5Sn0xJ0PZD-aOBlV1n9IUBJK6DzxvmUTT4iOzTyiqz8,118268
 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_indexes.py,sha256=dqM-HLy4hfL9pxgr11z0mUPGlHFIC1DJh09eHjiVNwU,20153
+spatial_memory/core/db_migrations.py,sha256=1lv6YvLMon_cJprsHVHu4uDLy8JeptaOWE_Ig0mJ-3Q,19126
+spatial_memory/core/db_search.py,sha256=mQE-fU6JUxThlBm2HOB3T6Bn_IxPJ18X7AvruR98Htc,19927
 spatial_memory/core/db_versioning.py,sha256=7LGWQO6EiwIgw-C5e81xG4jEO34b5y95Ag6uoVrU7Xw,5984
-spatial_memory/core/embeddings.py,sha256=g_C8rmrNH8qTroPcg-aYJo5Z6NR_YqGN050Iryytx5c,20892
+spatial_memory/core/embeddings.py,sha256=hixE3FakjUnjsL8nkqZ4EE8iP3XKApCniSuedp3Gt8A,20890
 spatial_memory/core/errors.py,sha256=mGQlPNNiNOdErYPXdEQXM1_-IeueUB_jtgdt8P8lzUQ,8799
-spatial_memory/core/file_security.py,sha256=kHIYEnZIRFz94FxCJ7oOHiaihgQRB1rsOHHmJprHNhU,25766
+spatial_memory/core/file_security.py,sha256=uBJDGhJNZutUCI2re2Gh0gnpY2R5V5lyTxGDZIWrhsw,25736
 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
@@ -30,7 +30,7 @@ spatial_memory/core/logging.py,sha256=JfFRzHmhZ2BPNSJiKIHGjfUeskFVo8Bj7nOKznvv0k
 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/response_types.py,sha256=X4wxPQq-BkochwqSjTkMQZ-J6BhupeI1wvV5V1q7s2c,10602
 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
@@ -38,17 +38,17 @@ spatial_memory/core/utils.py,sha256=YvvU3EbbAicR732LkHMM5-u4wvBaJ4G9DigBaB2CoI4,
 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/ports/repositories.py,sha256=6rUxGUfeAVudNU9ugaVTKedPGQONaIL0TrSQt7XR5HU,19857
+spatial_memory/services/__init__.py,sha256=9sYpYgQRTAq800I5ZS_GFcg5F_p3dUySe5fKN3S4vg4,1564
+spatial_memory/services/export_import.py,sha256=Ui1RFujtEhrDYKGXsQragUtpVfxq0eLwjnabB1h-F7c,38211
+spatial_memory/services/lifecycle.py,sha256=y1XSjJuCBou7wPdbRGyZsP30URw6iNqxjhlwYMLv79o,43010
 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/services/spatial.py,sha256=x-d8ucSpP1sNQR9ywylMwF884hYPkRDfNDhDGfUodwI,42609
+spatial_memory/services/utility.py,sha256=63i33hCnC9C2tLpTtGhuQ87_K4yU-sZMU2c7ldT24wM,14968
 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.6.2.dist-info/METADATA,sha256=CpNnbu3XX3URUhRgGkQuTJdeLr9PQE9TLQri34GVBk8,16772
+spatial_memory_mcp-1.6.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+spatial_memory_mcp-1.6.2.dist-info/entry_points.txt,sha256=nJ4RJBB9SvhNktJdikcAS27fSwtKekpgPR4GTy2r1cE,64
+spatial_memory_mcp-1.6.2.dist-info/licenses/LICENSE,sha256=g65vrroU3yJxekbYV8xmDj7KFrXAg89eCM8vcWrpKmU,1095
+spatial_memory_mcp-1.6.2.dist-info/RECORD,,