memplex 3.2.2__tar.gz → 3.2.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.2
+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.2 → memplex-3.2.4}/README.md

@@ -13,61 +13,67 @@
 
 ## Installation
 
-### Claude Code Plugin
+### One-Command Agent Setup
+
+No source checkout is required. The npm entrypoint matches the common
+`npx <tool> setup` pattern used by modern CLIs:
 
-**Option 1: Local plugin (for development)**
 ```bash
-# Clone and install locally
-cd plugin
-/plugin install ./plugin
+npx memplex setup
 ```
 
-**Option 2: Via marketplace**
+Install into a specific local agent:
+
 ```bash
-/plugin marketplace add ./marketplace.json
-/plugin install memplex
+npx memplex setup --agent codex --project-path "$PWD"
+npx memplex setup --agent claude-code --project-path "$PWD"
+npx memplex setup --agent openclaw --project-path "$PWD"
+npx memplex setup --agent hermes --project-path "$PWD"
 ```
 
-**Option 3: pip install**
+Install every supported agent config on this machine:
+
 ```bash
-pip install memplex
+npx memplex setup --agent all --project-path "$PWD"
 ```
 
-### From Source
+Uninstall:
 
 ```bash
-git clone https://github.com/articultur/memplex.git
-cd memplex
-pip install -e .
+npx memplex uninstall --agent all
 ```
 
-### Agent One-Command Install
+The npm wrapper creates a persistent Python environment at
+`~/.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`.
 
-For a machine that does not have this repository checked out, install Memplex
-into a detected local agent with:
+Python-first users can use a persistent tool install:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | bash
+uv tool install memplex==3.2.4
+memplex setup
 ```
 
-By default the script installs Memplex from GitHub into a persistent Python
-environment at `~/.local/share/memplex/agent-venv`, 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`.
+The raw hosted installer remains available for shell-only environments:
 
-Install a specific agent:
+```bash
+curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | bash
+```
+
+### Claude Code Plugin
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
-  bash -s -- --agent hermes --package memplex --project-path "$PWD" --user-id "$USER"
+memplex setup --agent claude-code
 ```
 
-Install every supported agent config on this machine:
+### From Source
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
-  bash -s -- --agent all --project-path "$PWD"
+git clone https://github.com/articultur/memplex.git
+cd memplex
+pip install -e .
 ```
 
 Uninstall:

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

@@ -1,6 +1,6 @@
 {
   "name": "memplex",
-  "version": "3.2.2",
+  "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.2 → memplex-3.2.4}/memplex/adapters/agent_installer.py

@@ -80,9 +80,33 @@ def uninstall_agent(
 
 
 def _expand_agents(agent: str) -> list[str]:
-    if (agent or "").strip().lower() == "all":
+    requested = (agent or "auto").strip().lower()
+    if requested == "all":
         return ["codex", "claude-code", "openclaw", "hermes"]
-    return [get_agent_manifest(agent)["name"]]
+    if requested == "auto":
+        detected = _detect_agents()
+        if not detected:
+            raise ValueError(
+                "No supported local agents detected. Re-run with "
+                "--agent codex|claude-code|openclaw|hermes|all."
+            )
+        return detected
+    return [get_agent_manifest(requested)["name"]]
+
+
+def _detect_agents() -> list[str]:
+    detected: list[str] = []
+    checks = [
+        ("codex", "CODEX_HOME", ".codex", "codex"),
+        ("claude-code", "CLAUDE_CONFIG_DIR", ".claude", "claude"),
+        ("openclaw", "OPENCLAW_CONFIG_DIR", ".openclaw", "openclaw"),
+        ("hermes", "HERMES_CONFIG_DIR", ".hermes", "hermes"),
+    ]
+    for name, env_name, default_name, command in checks:
+        root = Path(os.environ.get(env_name, Path.home() / default_name)).expanduser()
+        if root.exists() or shutil.which(command):
+            detected.append(name)
+    return detected
 
 
 def _install_one(
@@ -140,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,
             "",
         ]
@@ -334,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:
@@ -357,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",
@@ -414,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."],
     )
@@ -605,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(
@@ -925,4 +943,4 @@ def _package_version() -> str:
     try:
         return pkg_version("memplex")
     except Exception:
-        return "3.2.2"
+        return "3.2.4"

{memplex-3.2.2 → memplex-3.2.4}/memplex/adapters/cli.py

@@ -13,9 +13,11 @@ Usage::
     memplex compact --scope project
     memplex health
     memplex stats
+    memplex setup            # Install into detected local agents
+    memplex install --agent codex
+    memplex uninstall --agent openclaw
     memplex agent install --agent all
     memplex agent uninstall --agent openclaw
-    memplex setup            # Install as Claude Code plugin
     memplex unsetup          # Uninstall Claude Code plugin
 
 Global options::
@@ -395,80 +397,25 @@ def _get_marketplace_dir() -> Path:
 
 
 def cmd_setup(args: argparse.Namespace) -> int:
-    """Install Memplex as a Claude Code plugin."""
-    if getattr(args, "uninstall", False):
-        return cmd_unsetup(args)
-
-    market_dir = _get_marketplace_dir()
-    plugin_target = market_dir / "plugin"
-
-    print("Memplex Plugin Setup")
-    print("=" * 40)
-
-    # 1. Check Python dependencies
-    print("\n[1/4] Checking dependencies...")
-    try:
-        import numpy  # noqa: F401
-        import yaml  # noqa: F401
-
-        print("  Core dependencies: OK")
-    except ImportError as e:
-        print(f"  Missing dependency: {e}")
-        print("  Run: pip install memplex[embedding]")
-        return 1
-
-    # 2. Find and copy plugin directory
-    print("\n[2/4] Installing plugin files...")
-    try:
-        source = _get_plugin_source_dir()
-    except FileNotFoundError as e:
-        print(f"  Error: {e}")
-        return 1
-
-    if plugin_target.exists():
-        shutil.rmtree(plugin_target)
-
-    def _ignore_patterns(_dir, files):
-        return [f for f in files if f == "__pycache__" or f.endswith(".pyc")]
-
-    shutil.copytree(source, plugin_target, symlinks=False, ignore=_ignore_patterns)
-    print(f"  Installed to: {plugin_target}")
-
-    # 3. Write marketplace.json
-    print("\n[3/4] Registering with Claude Code...")
-    market_json = market_dir / "marketplace.json"
-    market_dir.mkdir(parents=True, exist_ok=True)
-    market_json.write_text(_MARKETPLACE_JSON.strip() + "\n")
-    print(f"  Marketplace: {market_json}")
-
-    # 4. Write install marker
-    print("\n[4/4] Writing install marker...")
-    marker = market_dir / ".install-version"
-    from importlib.metadata import version as pkg_version
+    """Install or uninstall Memplex in local agent hosts."""
+    from memplex.adapters.agent_installer import install_agent, uninstall_agent
 
-    try:
-        ver = pkg_version("memplex")
-    except Exception:
-        ver = "3.2.2"
-    marker.write_text(
-        json.dumps(
-            {
-                "version": ver,
-                "installedAt": __import__("datetime").datetime.now().isoformat(),
-            },
-            indent=2,
+    should_uninstall = getattr(args, "uninstall", False) or args.command == "uninstall"
+    if should_uninstall:
+        result = uninstall_agent(
+            args.agent,
+            target_dir=getattr(args, "target_dir", None),
+            dry_run=getattr(args, "dry_run", False),
         )
-    )
-    print(f"  Version: {ver}")
-
-    print("\n" + "=" * 40)
-    print("Memplex plugin installed successfully!")
-    print("\nWhat was configured:")
-    print(f"  - Hooks:    {plugin_target}/hooks/hooks.json")
-    print(f"  - MCP:      {plugin_target}/.mcp.json")
-    print(f"  - Skills:   {plugin_target}/skills/*/SKILL.md")
-    print(f"  - Manifest: {plugin_target}/../.claude-plugin/plugin.json")
-    print("\nRestart Claude Code to activate the plugin.")
+    else:
+        result = install_agent(
+            args.agent,
+            target_dir=getattr(args, "target_dir", None),
+            user_id=getattr(args, "user_id", None),
+            project_path=getattr(args, "project_path", None),
+            dry_run=getattr(args, "dry_run", False),
+        )
+    print(_fmt(_dataclass_to_dict(result), args.output))
     return 0
 
 
@@ -579,7 +526,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_install.add_argument(
         "--agent",
         default="all",
-        help="Agent id: codex | claude-code | openclaw | hermes | all",
+        help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
     )
     p_agent_install.add_argument(
         "--target-dir",
@@ -598,7 +545,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_uninstall.add_argument(
         "--agent",
         default="all",
-        help="Agent id: codex | claude-code | openclaw | hermes | all",
+        help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
     )
     p_agent_uninstall.add_argument(
         "--target-dir",
@@ -629,11 +576,39 @@ def build_parser() -> argparse.ArgumentParser:
     p_agent_capture.add_argument("--assistant-message", required=True)
     p_agent_capture.add_argument("--next-prompt-hint", default=None)
 
-    # -- setup --
-    p_setup = sub.add_parser("setup", help="Install Memplex as a Claude Code plugin")
-    p_setup.add_argument(
-        "--uninstall", action="store_true", help="Uninstall the plugin"
-    )
+    # -- setup / install / uninstall --
+    def add_setup_parser(name: str, *, uninstall: bool = False):
+        help_text = (
+            "Uninstall Memplex from local agent hosts"
+            if uninstall
+            else "Set up Memplex in detected local agent hosts"
+        )
+        p_setup = sub.add_parser(name, help=help_text)
+        p_setup.add_argument(
+            "--agent",
+            default="auto",
+            help="Agent id: auto | codex | claude-code | openclaw | hermes | all",
+        )
+        p_setup.add_argument(
+            "--target-dir",
+            default=None,
+            help="Override the selected agent config root directory",
+        )
+        p_setup.add_argument("--user-id", default=None)
+        p_setup.add_argument("--project-path", default=None)
+        p_setup.add_argument(
+            "--dry-run", action="store_true", help="Show planned files without writing"
+        )
+        if not uninstall:
+            p_setup.add_argument(
+                "--uninstall", action="store_true", help="Uninstall instead of install"
+            )
+        return p_setup
+
+    add_setup_parser("setup")
+    add_setup_parser("install")
+    add_setup_parser("stepup")
+    add_setup_parser("uninstall", uninstall=True)
 
     # -- unsetup --
     sub.add_parser("unsetup", help="Uninstall Memplex Claude Code plugin")
@@ -671,6 +646,9 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
         "stats": cmd_stats,
         "agent": cmd_agent,
         "setup": cmd_setup,
+        "install": cmd_setup,
+        "stepup": cmd_setup,
+        "uninstall": cmd_setup,
         "unsetup": cmd_unsetup,
     }
 

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

@@ -331,7 +331,7 @@ class MCPServer:
             },
             "serverInfo": {
                 "name": "memplex",
-                "version": "3.2.2",
+                "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.2 → 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.2 → 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.2 → memplex-3.2.4}/memplex.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.2
+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.2 → memplex-3.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memplex"
-version = "3.2.2"
+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.2 → memplex-3.2.4}/tests/test_agent_hot_paths.py

@@ -51,6 +51,68 @@ def test_codex_hot_path_uses_managed_mcp_block(tmp_path):
     assert 'args = ["-m", "memplex.adapters.mcp_server"]' in config
 
 
+def test_top_level_setup_auto_detects_agent_without_nested_command(tmp_path):
+    home = tmp_path / "home"
+    (home / ".codex").mkdir(parents=True)
+    result = _run_memplex(
+        [
+            "--output",
+            "json",
+            "setup",
+            "--dry-run",
+            "--project-path",
+            str(PROJECT_ROOT),
+        ],
+        env={**os.environ, "HOME": str(home), "PATH": "/usr/bin:/bin"},
+    )
+
+    assert result.returncode == 0, result.stderr
+    payload = json.loads(result.stdout)
+    assert payload[0]["agent"] == "codex"
+    assert payload[0]["action"] == "install"
+    assert payload[0]["status"] == "planned"
+
+
+def test_top_level_install_and_stepup_aliases(tmp_path):
+    for command in ("install", "stepup"):
+        result = _run_memplex(
+            [
+                "--output",
+                "json",
+                command,
+                "--agent",
+                "codex",
+                "--target-dir",
+                str(tmp_path / command),
+                "--dry-run",
+            ]
+        )
+        assert result.returncode == 0, result.stderr
+        payload = json.loads(result.stdout)
+        assert payload[0]["agent"] == "codex"
+        assert payload[0]["action"] == "install"
+
+
+def test_top_level_uninstall_alias(tmp_path):
+    result = _run_memplex(
+        [
+            "--output",
+            "json",
+            "uninstall",
+            "--agent",
+            "codex",
+            "--target-dir",
+            str(tmp_path / "codex"),
+            "--dry-run",
+        ]
+    )
+
+    assert result.returncode == 0, result.stderr
+    payload = json.loads(result.stdout)
+    assert payload[0]["agent"] == "codex"
+    assert payload[0]["action"] == "uninstall"
+
+
 def test_mcp_hot_path_initializes_over_stdio(tmp_path):
     codex_home = tmp_path / "codex"
     install = _run_memplex(