memplex 3.2.3__tar.gz → 3.2.4__tar.gz

{memplex-3.2.3 → memplex-3.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.3
+Version: 3.2.4
 Summary: Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval
 Requires-Python: >=3.11
 License-File: LICENSE

{memplex-3.2.3 → memplex-3.2.4}/README.md

@@ -44,7 +44,7 @@ npx memplex uninstall --agent all
 ```
 
 The npm wrapper creates a persistent Python environment at
-`~/.local/share/memplex/agent-venv`, installs `memplex==3.2.3`, detects local
+`~/.local/share/memplex/agent-venv`, installs `memplex==3.2.4`, detects local
 Codex, Claude Code, OpenClaw, and Hermes config directories/commands, then
 registers Memplex with each detected agent. It uses `uv` when available and
 falls back to `python -m venv` plus `pip`.
@@ -52,7 +52,7 @@ falls back to `python -m venv` plus `pip`.
 Python-first users can use a persistent tool install:
 
 ```bash
-uv tool install memplex==3.2.3
+uv tool install memplex==3.2.4
 memplex setup
 ```
 

{memplex-3.2.3 → memplex-3.2.4}/memplex/_plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memplex",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Multi-agent memory system -- persistent knowledge graph with 3-layer retrieval, compaction, and wiki",
   "author": {
     "name": "articultur"

{memplex-3.2.3 → memplex-3.2.4}/memplex/adapters/agent_installer.py

@@ -164,8 +164,8 @@ def _install_codex(target_dir: str | Path | None, *, dry_run: bool) -> AgentInst
             "[mcp_servers.memplex]",
             f'command = "{_python_command()}"',
             'args = ["-m", "memplex.adapters.mcp_server"]',
-            'startup_timeout_sec = 10',
-            'tool_timeout_sec = 60',
+            "startup_timeout_sec = 10",
+            "tool_timeout_sec = 60",
             MANAGED_END,
             "",
         ]
@@ -358,14 +358,10 @@ def _uninstall_openclaw(
         is_managed_entry = _is_managed_openclaw_entry(memplex_entry)
         config_changed = False
         previous_memory_slot = (
-            memplex_entry.get("config", {})
-            .get("managed", {})
-            .get("previousMemorySlot")
+            memplex_entry.get("config", {}).get("managed", {}).get("previousMemorySlot")
         )
         added_allow_entry = (
-            memplex_entry.get("config", {})
-            .get("managed", {})
-            .get("addedAllowEntry", False)
+            memplex_entry.get("config", {}).get("managed", {}).get("addedAllowEntry", False)
         )
         if is_managed_entry and slots.get("memory") == "memplex":
             if previous_memory_slot:
@@ -381,11 +377,7 @@ def _uninstall_openclaw(
             config_changed = True
         if config_changed and not dry_run:
             _write_json(config_path, config)
-    if (
-        extension_dir.exists()
-        and _is_managed_openclaw_extension(extension_dir)
-        and not dry_run
-    ):
+    if extension_dir.exists() and _is_managed_openclaw_extension(extension_dir) and not dry_run:
         shutil.rmtree(extension_dir)
     return AgentInstallResult(
         agent="openclaw",
@@ -438,7 +430,11 @@ def _install_hermes(
         agent="hermes",
         action="install",
         status="planned" if dry_run else "installed",
-        files=[str(provider_path), str(plugin_dir / "plugin.yaml"), str(plugin_dir / "__init__.py")],
+        files=[
+            str(provider_path),
+            str(plugin_dir / "plugin.yaml"),
+            str(plugin_dir / "__init__.py"),
+        ],
         message="Installed Memplex Hermes memory provider plugin and descriptor.",
         next_steps=["Restart Hermes and select the memplex memory provider."],
     )
@@ -629,9 +625,7 @@ def compact_memories(context):
     )
 
 
-def _write_hermes_provider_plugin(
-    plugin_dir: Path, provider_config: dict[str, Any]
-) -> None:
+def _write_hermes_provider_plugin(plugin_dir: Path, provider_config: dict[str, Any]) -> None:
     plugin_dir.mkdir(parents=True, exist_ok=True)
     (plugin_dir / "plugin.yaml").write_text(
         "\n".join(
@@ -949,4 +943,4 @@ def _package_version() -> str:
     try:
         return pkg_version("memplex")
     except Exception:
-        return "3.2.3"
+        return "3.2.4"

{memplex-3.2.3 → memplex-3.2.4}/memplex/adapters/mcp_server.py

@@ -331,7 +331,7 @@ class MCPServer:
             },
             "serverInfo": {
                 "name": "memplex",
-                "version": "3.2.3",
+                "version": "3.2.4",
             },
         }
 
@@ -353,9 +353,7 @@ class MCPServer:
             "content": [
                 {
                     "type": "text",
-                    "text": json.dumps(
-                        result, default=str, ensure_ascii=False, indent=2
-                    ),
+                    "text": json.dumps(result, default=str, ensure_ascii=False, indent=2),
                 }
             ],
         }
@@ -400,9 +398,7 @@ class MCPServer:
         )
         return {
             "total": len(result.results),
-            "scope": result.scope.value
-            if hasattr(result.scope, "value")
-            else str(result.scope),
+            "scope": result.scope.value if hasattr(result.scope, "value") else str(result.scope),
             "latency_ms": result.latency_ms,
             "results": [
                 {

{memplex-3.2.3 → memplex-3.2.4}/memplex/compaction.py

@@ -29,7 +29,16 @@ import logging
 import os
 import time
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
+
+
+def _ensure_aware(dt: datetime) -> datetime:
+    """Normalize a datetime to offset-aware UTC for safe arithmetic."""
+    if dt.tzinfo is None:
+        return dt.replace(tzinfo=timezone.utc)
+    return dt
+
+
 from pathlib import Path
 from typing import TYPE_CHECKING, List, Optional
 
@@ -251,9 +260,7 @@ class CompactionPipeline:
             skipped=False,
         )
 
-    async def _execute_stage(
-        self, stage: str, scope: CompactionScope
-    ) -> CompactionStageResult:
+    async def _execute_stage(self, stage: str, scope: CompactionScope) -> CompactionStageResult:
         """Dispatch to the correct stage handler."""
         handlers = {
             "extract": self._execute_extract,
@@ -334,9 +341,7 @@ class CompactionPipeline:
 
                 # Sort by weight * observation composite score
                 def _score(fv: FieldValue) -> float:
-                    return fv.weight * (
-                        fv.observation if fv.observation is not None else 1.0
-                    )
+                    return fv.weight * (fv.observation if fv.observation is not None else 1.0)
 
                 values.sort(key=_score, reverse=True)
                 for fv in values[max_values:]:
@@ -376,7 +381,7 @@ class CompactionPipeline:
 
         removed = 0
         processed = len(functions)
-        now = datetime.now()
+        now = datetime.now(timezone.utc)
 
         for func in functions:
             should_delete = False
@@ -394,7 +399,7 @@ class CompactionPipeline:
                     except (ValueError, TypeError):
                         updated = None
                 if updated is not None:
-                    age_days = (now - updated).days
+                    age_days = (now - _ensure_aware(updated)).days
                     if age_days > max_age_days and func.access_count < min_access:
                         should_delete = True
 
@@ -406,7 +411,7 @@ class CompactionPipeline:
                         review_until = datetime.fromisoformat(review_until)
                     except (ValueError, TypeError):
                         review_until = None
-                if review_until is not None and now > review_until:
+                if review_until is not None and now > _ensure_aware(review_until):
                     should_delete = True
                 elif review_until is None:
                     # No expiry set -- use TTL from creation
@@ -416,7 +421,7 @@ class CompactionPipeline:
                             created = datetime.fromisoformat(created)
                         except (ValueError, TypeError):
                             created = None
-                    if created is not None and (now - created).days > review_ttl:
+                    if created is not None and (now - _ensure_aware(created)).days > review_ttl:
                         should_delete = True
 
             # Prune deprecated FieldValue entries (not the whole Function)
@@ -457,7 +462,7 @@ class CompactionPipeline:
 
         functions = self._store.list_functions(limit=100000)
         max_age_days = self._config.compaction.prune_max_age_days
-        now = datetime.now()
+        now = datetime.now(timezone.utc)
         archived = 0
 
         for func in functions:
@@ -471,7 +476,7 @@ class CompactionPipeline:
             if updated is None:
                 continue
 
-            age_days = (now - updated).days
+            age_days = (now - _ensure_aware(updated)).days
             if age_days > max_age_days and func.access_count == 0:
                 # Write to archive
                 archive_file = archive_dir / f"{func.id}.json"

{memplex-3.2.3 → memplex-3.2.4}/memplex/retrieval/reranker.py

@@ -23,7 +23,15 @@ from __future__ import annotations
 
 import logging
 import math
-from datetime import datetime
+from datetime import datetime, timezone
+
+
+def _ensure_aware(dt: datetime) -> datetime:
+    if dt.tzinfo is None:
+        return dt.replace(tzinfo=timezone.utc)
+    return dt
+
+
 from typing import TYPE_CHECKING, Dict, List, Optional
 
 from memplex.models import SearchResult, SourceType
@@ -181,7 +189,7 @@ class Reranker:
                 updated_at = datetime.fromisoformat(updated_at)
             except (ValueError, TypeError):
                 return 0.5
-        days_since = max(0, (datetime.now() - updated_at).days)
+        days_since = max(0, (datetime.now(timezone.utc) - _ensure_aware(updated_at)).days)
         return min(1.0, math.exp(-days_since / 60))
 
     def _source_weight(self, source_type: SourceType) -> float:
@@ -212,7 +220,7 @@ class Reranker:
                 except (ValueError, TypeError):
                     last_accessed = None
             if last_accessed is not None:
-                days = max(0, (datetime.now() - last_accessed).days)
+                days = max(0, (datetime.now(timezone.utc) - _ensure_aware(last_accessed)).days)
                 recency = min(1.0, math.exp(-days / 60))
             else:
                 recency = 0.3

{memplex-3.2.3 → memplex-3.2.4}/memplex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.3
+Version: 3.2.4
 Summary: Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval
 Requires-Python: >=3.11
 License-File: LICENSE

{memplex-3.2.3 → memplex-3.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memplex"
-version = "3.2.3"
+version = "3.2.4"
 description = "Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval"
 requires-python = ">=3.11"
 dependencies = [

{memplex-3.2.3 → memplex-3.2.4}/tests/test_agent_runtime.py

@@ -46,6 +46,30 @@ def test_turn_loop_captures_and_recalls_without_manual_write(tmp_path):
     assert recalled.source == "live"
 
 
+def test_recall_tolerates_mixed_timestamp_awareness_after_capture(tmp_path):
+    from memplex.adapters.agent_runtime import AgentMemoryRuntime
+
+    service = _make_service(tmp_path / "memory.json")
+    runtime = AgentMemoryRuntime(
+        service=service,
+        agent="codex",
+        user_id="user-1",
+        session_id="session-1",
+        top_k=5,
+    )
+
+    runtime.after_response(
+        user_message="I prefer timezone aware release status updates.",
+        assistant_message="Captured.",
+    )
+
+    first = runtime.before_prompt("How should release status updates be written?")
+    second = runtime.before_prompt("How should release status updates be written?")
+
+    assert "timezone aware release status updates" in first.context
+    assert "timezone aware release status updates" in second.context
+
+
 def test_hermes_prefetch_returns_cached_context_for_next_turn(tmp_path):
     from memplex.adapters.agent_runtime import AgentMemoryRuntime
 

{memplex-3.2.3 → memplex-3.2.4}/tests/test_hooks.py

@@ -40,9 +40,7 @@ def mcp_server(tmp_path):
     return MCPServer(config=cfg)
 
 
-HOOK_RUNNER = str(
-    Path(__file__).resolve().parent.parent / "plugin" / "scripts" / "hook-runner.py"
-)
+HOOK_RUNNER = str(Path(__file__).resolve().parent.parent / "plugin" / "scripts" / "hook-runner.py")
 PROJECT_ROOT = Path(__file__).resolve().parent.parent
 
 
@@ -65,9 +63,7 @@ class TestHookRunner:
         test_env = {
             **os.environ,
             "MEMPLEX_STORAGE_BACKEND": "lite",
-            "MEMPLEX_PLUGIN_ROOT": str(
-                Path(__file__).resolve().parent.parent / "plugin"
-            ),
+            "MEMPLEX_PLUGIN_ROOT": str(Path(__file__).resolve().parent.parent / "plugin"),
             "MEMPLEX_PROJECT_ROOT": str(PROJECT_ROOT),
         }
         if env:
@@ -107,9 +103,7 @@ class TestHookRunner:
 
     def test_observation_exits_zero(self):
         stdin_data = '{"tool_name":"Write","tool_input":{"file_path":"/tmp/test.py"}}'
-        r = self._run_hook(
-            "observation", ["Write", "test-session-obs"], stdin_data=stdin_data
-        )
+        r = self._run_hook("observation", ["Write", "test-session-obs"], stdin_data=stdin_data)
         assert r.returncode == 0, f"stderr: {r.stderr}"
 
     def test_observation_empty_stdin_exits_zero(self):
@@ -201,9 +195,7 @@ class TestHookRunner:
         )
         assert capture.returncode == 0, capture.stderr
 
-        stdin_data = json.dumps(
-            {"tool_input": {"file_path": str(tmp_path / "nested.py")}}
-        )
+        stdin_data = json.dumps({"tool_input": {"file_path": str(tmp_path / "nested.py")}})
         r = self._run_hook(
             "file-context",
             stdin_data=stdin_data,
@@ -255,7 +247,7 @@ class TestMCPServerProtocol:
         result = mcp_server._handle_initialize({})
         assert result["protocolVersion"] == "2024-11-05"
         assert result["serverInfo"]["name"] == "memplex"
-        assert result["serverInfo"]["version"] == "3.2.3"
+        assert result["serverInfo"]["version"] == "3.2.4"
         assert "tools" in result["capabilities"]
 
     def test_tools_list_returns_definitions(self, mcp_server):
@@ -288,17 +280,13 @@ class TestMCPServerProtocol:
         tools = mcp_server._handle_tools_list({})["tools"]
         search_tool = next(t for t in tools if t["name"] == "memory_search")
         assert (
-            "ALWAYS" in search_tool["description"]
-            or "filter" in search_tool["description"].lower()
+            "ALWAYS" in search_tool["description"] or "filter" in search_tool["description"].lower()
         )
 
     def test_get_tool_emphasizes_after_search(self, mcp_server):
         tools = mcp_server._handle_tools_list({})["tools"]
         get_tool = next(t for t in tools if t["name"] == "memory_get")
-        assert (
-            "AFTER" in get_tool["description"]
-            or "search" in get_tool["description"].lower()
-        )
+        assert "AFTER" in get_tool["description"] or "search" in get_tool["description"].lower()
 
 
 class TestMCPServerTools:
@@ -473,9 +461,7 @@ class TestMCPServerTools:
         cfg_path = tmp_path / "memplex.yaml"
         cfg_path.write_text("storage:\n  backend: lite\n  path: '%s'" % str(tmp_path))
 
-        init_msg = json.dumps(
-            {"jsonrpc": "2.0", "method": "initialize", "params": {}, "id": 1}
-        )
+        init_msg = json.dumps({"jsonrpc": "2.0", "method": "initialize", "params": {}, "id": 1})
         search_msg = json.dumps(
             {
                 "jsonrpc": "2.0",
@@ -552,14 +538,10 @@ class TestCLI:
         assert r.returncode == 0
 
     def test_write_text_command(self):
-        r = self._run_cli(
-            ["write", "--text", "CLI写入测试：当系统启动时，加载配置文件"]
-        )
+        r = self._run_cli(["write", "--text", "CLI写入测试：当系统启动时，加载配置文件"])
         assert r.returncode == 0
         assert (
-            "function" in r.stdout.lower()
-            or "extracted" in r.stdout.lower()
-            or "func_" in r.stdout
+            "function" in r.stdout.lower() or "extracted" in r.stdout.lower() or "func_" in r.stdout
         )
 
     def test_json_output(self):
@@ -729,9 +711,7 @@ class TestCLI:
         assert config["plugins"]["slots"]["memory"] == "memplex"
         assert config["plugins"]["entries"]["memplex"]["config"]["userId"] == "alice"
         assert config["plugins"]["entries"]["memplex"]["config"]["projectPath"] == "/repo/a"
-        plugin = json.loads(
-            (target / "extensions" / "memplex" / "plugin.json").read_text()
-        )
+        plugin = json.loads((target / "extensions" / "memplex" / "plugin.json").read_text())
         openclaw_plugin = json.loads(
             (target / "extensions" / "memplex" / "openclaw.plugin.json").read_text()
         )
@@ -790,9 +770,7 @@ class TestCLI:
         config = json.loads((target / "openclaw.json").read_text())
         assert config["plugins"]["slots"]["memory"] == "memplex"
         assert (
-            config["plugins"]["entries"]["memplex"]["config"]["managed"][
-                "previousMemorySlot"
-            ]
+            config["plugins"]["entries"]["memplex"]["config"]["managed"]["previousMemorySlot"]
             == "existing-memory"
         )
 
@@ -910,12 +888,12 @@ class TestCLI:
         target.mkdir()
         config_path = target / "openclaw.json"
         original = (
-            '{\n'
-            '  // user-managed config\n'
+            "{\n"
+            "  // user-managed config\n"
             '  "plugins": {\n'
             '    "slots": {"memory": "custom-memory",},\n'
-            '  },\n'
-            '}\n'
+            "  },\n"
+            "}\n"
         )
         config_path.write_text(original)
 
@@ -1293,22 +1271,18 @@ class TestPluginConfig:
             Path(PROJECT_ROOT / "plugin" / ".claude-plugin" / "plugin.json").read_text()
         )
         assert data["name"] == "memplex"
-        assert data["version"] == "3.2.3"
+        assert data["version"] == "3.2.4"
         assert "repository" in data
 
     def test_hooks_json_valid(self):
-        data = json.loads(
-            Path(PROJECT_ROOT / "plugin" / "hooks" / "hooks.json").read_text()
-        )
+        data = json.loads(Path(PROJECT_ROOT / "plugin" / "hooks" / "hooks.json").read_text())
         assert "hooks" in data
         assert "SessionStart" in data["hooks"]
         assert "PostToolUse" in data["hooks"]
         assert "Stop" in data["hooks"]
 
     def test_hooks_json_has_timeout(self):
-        data = json.loads(
-            Path(PROJECT_ROOT / "plugin" / "hooks" / "hooks.json").read_text()
-        )
+        data = json.loads(Path(PROJECT_ROOT / "plugin" / "hooks" / "hooks.json").read_text())
         for hook_group in data["hooks"]["SessionStart"]:
             for hook in hook_group["hooks"]:
                 assert "timeout" in hook

{memplex-3.2.3 → memplex-3.2.4}/tests/test_install_scripts.py

@@ -161,11 +161,11 @@ def test_agent_installer_all_uses_transactional_cli_path(tmp_path):
 def test_npm_hermes_installer_package_shape():
     memplex_package = json.loads(NPM_MEMPLEX_PACKAGE.read_text())
     assert memplex_package["name"] == "memplex"
-    assert memplex_package["version"] == "3.2.3"
+    assert memplex_package["version"] == "3.2.4"
     assert memplex_package["bin"]["memplex"] == "bin/memplex.js"
     memplex_script = NPM_MEMPLEX_BIN.read_text()
     assert "npx memplex setup" in memplex_script
-    assert "memplex==3.2.3" in memplex_script
+    assert "memplex==3.2.4" in memplex_script
 
     agent_package = json.loads(NPM_AGENT_PACKAGE.read_text())
     assert agent_package["name"] == "@articultur/memplex-agent-installer"
@@ -209,7 +209,7 @@ def test_npm_memplex_setup_runs_hosted_installer_dry_run(tmp_path):
         },
     )
     assert result.returncode == 0, result.stderr
-    assert "memplex==3.2.3" in result.stdout
+    assert "memplex==3.2.4" in result.stdout
     assert "-m memplex agent install --agent codex" in result.stdout
     assert "--project-path /repo/a" in result.stdout