mcpaisuite-memorymcp 1.0.3__tar.gz

mcpaisuite_memorymcp-1.0.3/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI — memorymcp
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: pip install -e ".[dev]"
+      - name: Lint (ruff)
+        run: |
+          pip install ruff
+          ruff check .
+      - name: Security scan (bandit)
+        run: |
+          pip install bandit
+          bandit -r memorymcp/ -c .bandit --severity-level medium 2>&1 || true
+      - name: Tests
+        run: python -m pytest tests/ -v --tb=short --cov=memorymcp --cov-report=term-missing --cov-fail-under=50

mcpaisuite_memorymcp-1.0.3/.github/workflows/release.yml

@@ -0,0 +1,26 @@
+name: release
+# Publishes to PRODUCTION PyPI (pypi.org) when you push a version tag, e.g.
+# `git tag v1.0.3 && git push --tags`.
+# Auth = PyPI Trusted Publishing (OIDC): NO stored token. You must add this repo+workflow
+# as a (pending) trusted publisher on pypi.org first: https://pypi.org/manage/account/publishing/
+on:
+  push:
+    tags:
+      - 'v*'
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read    # checkout needs read access (private repo)
+      id-token: write   # short-lived OIDC token for Trusted Publishing — no secret stored
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Publish to PyPI (Trusted Publishing, no token)
+        uses: pypa/gh-action-pypi-publish@release/v1

mcpaisuite_memorymcp-1.0.3/.gitignore

@@ -0,0 +1,35 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+.env
+.env.*
+*.log
+
+.venv/
+venv/
+env/
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+
+*.db
+*.sqlite3
+
+node_modules/
+.next/
+.turbo/
+
+.DS_Store
+Thumbs.db
+
+llm_config.json
+plan.md

mcpaisuite_memorymcp-1.0.3/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+## Unreleased
+
+### Fixed
+- `decay_mode="adaptive"` is now a real, selectable decay mode: it always applies the retrieval-frequency slowdown, independent of the engine's global `adaptive` flag. Previously it silently fell through to plain `exponential` (no boost) when the global flag was off.
+- Tier TTL defaults corrected so a hot-cache entry no longer outlives a working-memory entry: `HotCache` TTL `3600s → 300s` (5 min), `WorkingStore` TTL `1800s → 3600s` (1 h).
+
+## 2.0.0 (2026-04-26)
+
+Initial release.
+
+### Core
+- 4-tier memory architecture: Hot Cache, Working Memory, Episodic Store, Semantic Store
+- `MemoryPipeline` — central orchestrator for all memory operations
+- `MemoryFactory` — configurable factory with `default()`, `create()`, `from_yaml()`, `from_env()`
+- Pydantic v2 models for all data structures
+
+### Extraction
+- `PatternFactExtractor` — zero-dependency regex-based fact extraction
+- `LLMFactExtractor` — LLM-powered extraction with conversation context, correction detection, and decay mode assignment
+- Question and noise filtering (`_is_non_informative`)
+
+### Memory Management
+- `ConsolidationEngine` — deduplication (SKIP), contradiction detection (OVERWRITE), complement merging (UPDATE)
+- `DecayEngine` — exponential, linear, and anchored decay modes with adaptive retrieval boost
+- `ConfidenceTracker` — confirmation counting and confidence scoring
+- `HeuristicImportanceScorer` — automatic importance scoring
+
+### Graph
+- `InMemoryFactGraph` — fact relations with traversal (supports, contradicts, supersedes, related_to, created_by, etc.)
+- LLM-based relation extraction
+
+### Context Assembly
+- `ContextAssembler` — token-budgeted context with episodic/semantic blend
+- Query enrichment for short/ambiguous queries using conversation history
+- Markdown rendering for LLM consumption
+
+### MCP Server
+- 9 tools: query_memory, store_fact, add_episode, get_session_context, assemble_context, set_working_memory, get_working_memory, forget_fact, memory_stats
+- stdio and SSE transport
+
+### CLI
+- `memorymcp serve` — start MCP server
+- `memorymcp query` — search memory
+- `memorymcp store` — store a fact
+- `memorymcp stats` — memory health
+- `memorymcp consolidate` — run consolidation cycle
+- `memorymcp forget-user` — GDPR data deletion
+
+### Privacy
+- PII filter with regex-based redaction (email, phone, SSN, credit card)
+- Namespace-based multi-tenancy with full isolation
+- `forget_user()` for complete data deletion
+
+### Demo
+- Full-stack dashboard (FastAPI + Next.js)
+- Chat interface with streaming, fact extraction badges, memory retrieval panel
+- Memory Browser, Sessions, Graph Explorer, Analytics, Memory Lab, Settings
+- Tenant switcher with create/delete/switch
+- LLM settings (OpenAI, Anthropic, Ollama, OpenAI-compatible)