memplex 3.2.0__tar.gz → 3.2.2__tar.gz

memplex-3.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Memplex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: memplex
-Version: 3.2.0
+Version: 3.2.2
 Summary: Memplex - Memory Complex: multi-agent knowledge graph memory system with 3-layer retrieval
 Requires-Python: >=3.11
+License-File: LICENSE
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: numpy>=1.24.0
 Requires-Dist: requests>=2.28.0
@@ -30,8 +31,9 @@ Requires-Dist: asyncpg>=0.29.0; extra == "postgres"
 Provides-Extra: neo4j
 Requires-Dist: neo4j>=5.0.0; extra == "neo4j"
 Provides-Extra: all
-Requires-Dist: memnex[embedding,extractors,graph,http,llm,vector]; extra == "all"
+Requires-Dist: memplex[embedding,extractors,graph,http,llm,vector]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file

memplex-3.2.2/README.md

@@ -0,0 +1,130 @@
+# Memplex
+
+**Memplex** is a persistent knowledge graph memory system for AI agents. It extracts structured knowledge from documents, URLs, and conversations, then provides 3-layer retrieval across sessions.
+
+## Features
+
+- **4 Memory Types**: Function (procedural), Fact (declarative), Preference (user prefs), Observation (runtime events)
+- **3-Layer Retrieval**: Search → Timeline → Get (10x token savings vs fetching everything)
+- **5-Dim Reranker**: raw_relevance, semantic_similarity, recency_decay, source_authority, frequency
+- **5-Stage Compaction**: Extract → Dedup → Summarize → Prune → Archive
+- **Wiki Layer**: WikiCompiler + DualIndexSearch (FTS + vector RRF) + GraphRAG community detection
+- **Lifecycle Hooks**: Auto-collect observations from tool usage, compact on session end
+
+## Installation
+
+### Claude Code Plugin
+
+**Option 1: Local plugin (for development)**
+```bash
+# Clone and install locally
+cd plugin
+/plugin install ./plugin
+```
+
+**Option 2: Via marketplace**
+```bash
+/plugin marketplace add ./marketplace.json
+/plugin install memplex
+```
+
+**Option 3: pip install**
+```bash
+pip install memplex
+```
+
+### From Source
+
+```bash
+git clone https://github.com/articultur/memplex.git
+cd memplex
+pip install -e .
+```
+
+### Agent One-Command Install
+
+For a machine that does not have this repository checked out, install Memplex
+into a detected local agent with:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | bash
+```
+
+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`.
+
+Install a specific agent:
+
+```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"
+```
+
+Install every supported agent config on this machine:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
+  bash -s -- --agent all --project-path "$PWD"
+```
+
+Uninstall:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/articultur/memplex/main/scripts/install-agent.sh | \
+  bash -s -- --agent hermes --uninstall
+```
+
+## Claude Code Setup
+
+After installation, initialize Memplex:
+
+```bash
+memplex config init
+```
+
+This creates `memplex.yaml` with your configuration.
+
+## Quick Start
+
+```bash
+# Write content to memory
+memplex write "Python list comprehensions are faster than loops"
+
+# Query memory
+memplex query "python performance"
+
+# Run compaction
+memplex compact
+
+# Health check
+memplex health
+```
+
+## Adapters
+
+| Adapter | Entry Point | Description |
+|---------|------------|-------------|
+| CLI | `memplex` / `python -m memplex` | 9 subcommands |
+| HTTP API | `memplex.adapters.http_api` | FastAPI with 11 REST endpoints |
+| MCP | `memplex.adapters.mcp_server` | stdio JSON-RPC, 9 tools |
+| Claude Skill | `plugin/skills/` | Claude Code SKILL.md files |
+
+## Configuration
+
+`memplex config init` creates `memplex.yaml`. Override via env vars `MEMPLEX_*`.
+
+## Storage
+
+- **Default**: LiteMemoryStore (in-memory + JSON persistence at `.memplex/memory.json`)
+- **Optional**: ChromaDB (vector embeddings), SQLite/Postgres (feedback)
+
+## Privacy
+
+`<private>content</private>` tags prevent storage of tagged content.
+
+## License
+
+MIT

memplex-3.2.2/memplex/__init__.py

@@ -0,0 +1,32 @@
+"""Memplex -- multi-agent memory system.
+
+Primary entry point::
+
+    from memplex import MemplexService
+
+    svc = MemplexService()
+    result = svc.query("登录函数在哪")
+
+CLI usage::
+
+    memplex query "search text"
+    memplex write --text "content"
+    memplex health
+"""
+
+from memplex.core import CoreEngine
+from memplex.service import MemplexService
+
+__all__ = ["CoreEngine", "MemplexService", "main"]
+
+
+def main() -> None:
+    """CLI entry point for ``memplex`` command.
+
+    Delegates to :func:`memplex.adapters.cli.main`.
+    """
+    import sys
+
+    from memplex.adapters.cli import main as cli_main
+
+    sys.exit(cli_main())

memplex-3.2.2/memplex/__main__.py

@@ -0,0 +1,7 @@
+"""Entry point for ``python -m memplex``."""
+
+import sys
+
+from memplex.adapters.cli import main
+
+sys.exit(main())

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

@@ -1,11 +1,11 @@
 {
   "name": "memplex",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Multi-agent memory system -- persistent knowledge graph with 3-layer retrieval, compaction, and wiki",
   "author": {
     "name": "articultur"
   },
-  "repository": "https://github.com/articultur/MemNex",
+  "repository": "https://github.com/articultur/Memplex",
   "license": "Apache-2.0",
   "keywords": [
     "claude",
@@ -20,5 +20,5 @@
     "python",
     "fastapi"
   ],
-  "homepage": "https://github.com/articultur/MemNex#readme"
+  "homepage": "https://github.com/articultur/Memplex#readme"
 }

{memplex-3.2.0/memnex → memplex-3.2.2/memplex}/_plugin/.mcp.json

@@ -1,9 +1,9 @@
 {
   "mcpServers": {
-    "memnex": {
+    "memplex": {
       "type": "stdio",
       "command": "python",
-      "args": ["-m", "memnex.adapters.mcp_server"]
+      "args": ["-m", "memplex.adapters.mcp_server"]
     }
   }
 }

memplex-3.2.2/memplex/_plugin/hooks/hooks.json

@@ -0,0 +1,81 @@
+{
+  "description": "Memplex memory system hooks",
+  "hooks": {
+    "Setup": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" setup",
+            "timeout": 300
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" session-start",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" prompt-submit",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" file-context",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" observation \"$MEMPLEX_TOOL_NAME\" \"$MEMPLEX_SESSION_ID\"",
+            "timeout": 120
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "shell": "bash",
+            "command": "export PATH=\"$($SHELL -lc 'echo $PATH' 2>/dev/null):$PATH\"; _C=\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"; _E=\"${MEMPLEX_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}\"; _P=$({ [ -n \"$_E\" ] && printf '%s\\n' \"$_E\"; ls -dt \"$_C/plugins/cache/articultur/memplex\"/[0-9]*/ 2>/dev/null; printf '%s\\n' \"$_C/plugins/marketplaces/articultur/plugin\"; } | while IFS= read -r _R; do _R=\"${_R%/}\"; [ -d \"$_R/plugin/scripts\" ] && _Q=\"$_R/plugin\" || _Q=\"$_R\"; [ -f \"$_Q/scripts/hook-runner.py\" ] && { printf '%s\\n' \"$_Q\"; break; }; done); [ -n \"$_P\" ] || { echo \"memplex: hook-runner.py not found\" >&2; exit 1; }; _PY=\"${MEMPLEX_PYTHON:-$(command -v python3 || command -v python || true)}\"; [ -n \"$_PY\" ] || { echo \"memplex: python not found\" >&2; exit 1; }; \"$_PY\" \"$_P/scripts/hook-runner.py\" summarize",
+            "timeout": 120
+          }
+        ]
+      }
+    ]
+  }
+}