memorius 0.9.2__tar.gz → 0.9.4__tar.gz

{memorius-0.9.2/memorius.egg-info → memorius-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memorius
-Version: 0.9.2
+Version: 0.9.4
 Summary: Self-contained memory vault for any AI agent — vector search, session diaries, and agent-agnostic hooks.
 Author-email: dimonapatrick243 <dimona.patrick@gmail.com>
 License-Expression: MIT
@@ -13,12 +13,13 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: chromadb>=0.4.22
+Requires-Dist: chromadb<1.0.0,>=0.4.22
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: fastapi>=0.104.1
 Requires-Dist: uvicorn[standard]>=0.24.0
@@ -45,7 +46,7 @@ Dynamic: license-file
   <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml/badge.svg" alt="PyPI publish"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
   <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12"></a>
-  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.2-green" alt="Changelog"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.3-green" alt="Changelog"></a>
 </p>
 
 > **Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, OpenClaw, and any MCP-compatible agent.**

{memorius-0.9.2 → memorius-0.9.4}/README.md

@@ -11,7 +11,7 @@
   <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml/badge.svg" alt="PyPI publish"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
   <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12"></a>
-  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.2-green" alt="Changelog"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.3-green" alt="Changelog"></a>
 </p>
 
 > **Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, OpenClaw, and any MCP-compatible agent.**

{memorius-0.9.2 → memorius-0.9.4}/memorius/cli/main.py

@@ -125,6 +125,11 @@ def main():
 
     serve_p = subparsers.add_parser("serve", help="Start MCP server (stdio)")
     serve_p.add_argument("--port", type=int, default=8911, help="Not used for stdio")
+    serve_p.add_argument(
+        "--reclaim",
+        action="store_true",
+        help="Reclaim the lock from an orphaned memorius serve instance",
+    )
 
     serve_rest_p = subparsers.add_parser("serve-rest", help="Start REST API server")
     serve_rest_p.add_argument("--port", type=int, default=None, help="Port")
@@ -347,7 +352,7 @@ def main():
         )
 
         try:
-            _serve_lock = acquire_serve_lock(config)
+            _serve_lock = acquire_serve_lock(config, reclaim=getattr(args, "reclaim", False))
         except ServeAlreadyRunningError as exc:
             print(
                 f"memorius: {exc}",
@@ -355,6 +360,7 @@ def main():
             )
             print(
                 f"   Stop that instance (kill {exc.pid} or stop its MCP host) and retry,\n"
+                f"   or rerun with `memorius serve --reclaim` to take over an orphaned instance,\n"
                 f"   or point this instance at a different storage path via MEMORIUS_STORAGE_PATH.",
                 file=sys.stderr,
             )

{memorius-0.9.2 → memorius-0.9.4}/memorius/mcp_server.py

@@ -133,7 +133,7 @@ class McpServer:
                 "properties": {
                     "vault": {"type": "string", "description": "Filter by vault (default: all)"},
                     "similarity_threshold": {"type": "number", "description": "Similarity threshold 0-1 (default: 0.80)", "default": 0.80},
-                    "dry_run": {"type": "boolean", "description": "Preview without changes (default: false)", "default": False},
+                    "dry_run": {"type": "boolean", "description": "Preview without changes (default: true)", "default": True},
                 },
             },
         },
@@ -620,7 +620,7 @@ class McpServer:
         result = self._engine.consolidate(
             vault=args.get("vault"),
             similarity_threshold=args.get("similarity_threshold", 0.80),
-            dry_run=args.get("dry_run", False),
+            dry_run=args.get("dry_run", True),
         )
         return {
             "clusters_found": result.clusters_found,

{memorius-0.9.2 → memorius-0.9.4}/memorius/single_instance.py

@@ -106,10 +106,12 @@ def _pid_alive(pid: int) -> bool:
     return True
 
 
-def acquire_serve_lock(config: dict[str, Any]) -> ServeLock:
+def acquire_serve_lock(config: dict[str, Any], reclaim: bool = False) -> ServeLock:
     """Acquire the single-instance guard lock for the configured storage dir.
 
-    Raises ``ServeAlreadyRunningError`` when a live incumbent holds it.
+    Raises ``ServeAlreadyRunningError`` when a live incumbent holds it and
+    ``reclaim`` is false. When ``reclaim`` is true, an orphaned live holder
+    is terminated and the lock is taken over.
     On platforms without ``fcntl`` returns an unlocked no-op handle after
     logging a warning (the guard is unavailable, but serve still works).
     """
@@ -132,10 +134,15 @@ def acquire_serve_lock(config: dict[str, Any]) -> ServeLock:
             os.close(fd)
             last_pid = _read_lock_pid(lock_path)
             # A dead holder's flock was already released by the kernel:
-            # retry and steal. A live holder: fail with its PID.
-            if last_pid is not None and _pid_alive(last_pid):
-                raise ServeAlreadyRunningError(last_pid, lock_path) from None
-            continue
+            # retry and steal.
+            if last_pid is None or not _pid_alive(last_pid):
+                continue
+            # Live holder: reclaim if requested (orphaned memorius serve),
+            # otherwise fail.
+            if reclaim and _is_memorius_serve(last_pid):
+                _reclaim_lock(last_pid)
+                continue
+            raise ServeAlreadyRunningError(last_pid, lock_path) from None
         except OSError:
             os.close(fd)
             raise
@@ -151,3 +158,37 @@ def acquire_serve_lock(config: dict[str, Any]) -> ServeLock:
     raise ServeAlreadyRunningError(
         last_pid if last_pid is not None else os.getpid(), lock_path
     )
+
+
+def _is_memorius_serve(pid: int) -> bool:
+    """True when /proc/<pid>/cmdline indicates a `memorius serve` process."""
+    try:
+        cmdline = Path(f"/proc/{pid}/cmdline").read_bytes().replace(b"\x00", b" ")
+    except OSError:
+        return False
+    return b"memorius" in cmdline and b"serve" in cmdline
+
+
+def _reclaim_lock(pid: int) -> None:
+    """Terminate an orphaned `memorius serve` holder so the lock can be taken."""
+    import signal
+    import time
+
+    logger.warning(
+        "reclaiming serve lock held by orphaned memorius serve (PID %d)", pid
+    )
+    try:
+        os.kill(pid, signal.SIGTERM)
+    except OSError:
+        return  # already gone
+    # Wait up to ~3s for the kernel to release the flock on exit.
+    for _ in range(30):
+        try:
+            os.kill(pid, 0)
+        except OSError:
+            return  # gone
+        time.sleep(0.1)
+    try:
+        os.kill(pid, signal.SIGKILL)
+    except OSError:
+        pass

{memorius-0.9.2 → memorius-0.9.4}/memorius/vault.py

@@ -42,6 +42,10 @@ class VaultEngine:
     """
 
     def __init__(self, config: dict[str, Any] | None = None):
+        # Class-level default so close()/__del__ on a half-initialized
+        # engine (e.g. EmbeddingFactory raising in __init__) can't crash
+        # with AttributeError and mask the real error.
+        self._consolidation_daemon = None
         self._config = config or load_config()
         embed_cfg = self._config.get("embeddings", {})
         storage_cfg = self._config.get("storage", {})

{memorius-0.9.2 → memorius-0.9.4/memorius.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memorius
-Version: 0.9.2
+Version: 0.9.4
 Summary: Self-contained memory vault for any AI agent — vector search, session diaries, and agent-agnostic hooks.
 Author-email: dimonapatrick243 <dimona.patrick@gmail.com>
 License-Expression: MIT
@@ -13,12 +13,13 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: chromadb>=0.4.22
+Requires-Dist: chromadb<1.0.0,>=0.4.22
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: fastapi>=0.104.1
 Requires-Dist: uvicorn[standard]>=0.24.0
@@ -45,7 +46,7 @@ Dynamic: license-file
   <a href="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml"><img src="https://github.com/Dream-Pixels-Forge/memorius/actions/workflows/release.yml/badge.svg" alt="PyPI publish"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
   <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12"></a>
-  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.2-green" alt="Changelog"></a>
+  <a href="https://github.com/Dream-Pixels-Forge/memorius/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-v0.9.3-green" alt="Changelog"></a>
 </p>
 
 > **Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, OpenClaw, and any MCP-compatible agent.**

{memorius-0.9.2 → memorius-0.9.4}/memorius.egg-info/requires.txt

@@ -1,5 +1,5 @@
 pyyaml>=6.0.1
-chromadb>=0.4.22
+chromadb<1.0.0,>=0.4.22
 httpx>=0.25.0
 fastapi>=0.104.1
 uvicorn[standard]>=0.24.0

{memorius-0.9.2 → memorius-0.9.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "memorius"
-version = "0.9.2"
+version = "0.9.4"
 description = "Self-contained memory vault for any AI agent — vector search, session diaries, and agent-agnostic hooks."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -15,12 +15,13 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
 
 dependencies = [
     "pyyaml>=6.0.1",
-    "chromadb>=0.4.22",
+    "chromadb>=0.4.22,<1.0.0",
     "httpx>=0.25.0",
     "fastapi>=0.104.1",
     "uvicorn[standard]>=0.24.0",

{memorius-0.9.2 → memorius-0.9.4}/tests/test_integration.py

@@ -3,6 +3,7 @@
 import json
 import os
 import shutil
+import site
 import subprocess
 import sys
 import tempfile
@@ -11,6 +12,11 @@ from pathlib import Path
 
 import pytest
 
+# Resolve the real user site-packages BEFORE any fixture overrides HOME —
+# once HOME points at a temp dir, site.getusersitepackages() returns the
+# (useless) fake path and deps installed in ~/.local become unimportable.
+_USER_SITE = site.getusersitepackages()
+
 
 def _safe_rmtree(path):
     """rmtree tolerant of Windows file locks.
@@ -40,6 +46,18 @@ def isolated_env():
         # Sandbox HOME so memorius init writes to ~/.memorius inside tmpdir
         fake_home = Path(tmpdir) / "home"
         fake_home.mkdir()
+        # chromadb's default ONNX embedding function hardcodes its cache at
+        # ~/.cache/chroma/onnx_models (no env override), and memorius's own
+        # pre-download checks ~/.cache/memorius/onnx_models — a sandboxed
+        # HOME makes both miss and re-download ~80MB from S3 per test.
+        # Reuse the developer's real (read-only, immutable) caches when
+        # present; on CI they don't exist and chromadb downloads as before.
+        for rel in (".cache/chroma/onnx_models", ".cache/memorius/onnx_models"):
+            real_cache = Path(old_home) / rel
+            if real_cache.is_dir():
+                link_parent = fake_home / Path(rel).parent
+                link_parent.mkdir(parents=True)
+                (link_parent / Path(rel).name).symlink_to(real_cache)
         os.environ["HOME"] = str(fake_home)
         os.environ["MEMORIUS_STORAGE_PATH"] = str(Path(tmpdir) / "data")
 
@@ -64,8 +82,7 @@ def run_memorius(*args, env=None, input_text=None, timeout=180):
     # When HOME is overridden in tests, Python's user site-packages shifts
     # to the fake HOME, breaking imports of dependencies like chromadb.
     src_dir = str(Path(__file__).resolve().parent.parent)
-    import site
-    user_site = site.getusersitepackages()
+    user_site = _USER_SITE
     merged_env = {**os.environ, **(env or {})}
     existing_pp = merged_env.get("PYTHONPATH", "")
     extra = os.pathsep.join([src_dir, user_site])