v1.0.0 — Universal Two-Layer Memory MCP Server

mcp-ariel-memory v1.0.0

Production-ready MCP server providing persistent, searchable memory for AI agents.

Features

• 19 unified MCP tools with layer parameter (user/agent)
• 4-layer memory architecture (L1-L4)
• Typed memory — 13 categories with per-type retention, decay, and boost
• RAG search — FTS5 + binary embeddings + hybrid scoring
• Knowledge graphs — Epistemic (facts/decisions) + Temporal (timeline)
• Wiki system — .md files as source of truth, 14 content types
• Saga pattern — Multi-step ops with retry, idempotency, compensation
• Envelope encryption — libsodium secretbox, keychain-first key resolution
• Platform-aware async — aiosqlite on Linux/macOS, asyncio.to_thread on Windows

Testing

• 338 tests — unit + integration + 25 property-based Hypothesis tests
• CI pipeline — lint (ruff), typecheck (mypy), quality (skylos), security (gitleaks + pip-audit), test matrix (3.10-3.13)
• Coverage — 61% (baseline, improving)

Security

• Secret scanning + push protection
• CodeQL analysis (default setup)
• Docker non-root user (UID 1000)
• CORS restricted to localhost
• gitleaks + pip-audit in CI

Documentation

• MkDocs site: https://cipher208.github.io/mcp-ariel-memory/
• Architecture diagrams (mermaid)
• API reference (auto-generated from docstrings)

What's Changed

Other Changes

• Update issue templates by @Cipher208 in #2
• chore: add issue templates by @Cipher208 in #8
• chore: add release workflow by @Cipher208 in #9
• fix: flaky auth crypto test by @Cipher208 in #10
• fix: test_bearer_token_encrypted fails on CI Python 3.12 by @Cipher208 in #11
• chore: add GitHub best practices — PR template, CODEOWNERS, auto-label, auto-merge, stale bot by @Cipher208 in #12
• chore: add mypy typecheck + detect-secrets to CI by @Cipher208 in #13
• fix: resolve detect-secrets merge conflict by @Cipher208 in #14
• fix: detect-secrets --output flag not supported by @Cipher208 in #15
• fix: resolve detect-secrets merge conflict by @Cipher208 in #16
• chore: add Hypothesis property-based tests (19 tests) by @Cipher208 in #17
• fix: resolve hypothesis test merge conflict by @Cipher208 in #18
• chore: delete requirements.txt, add ring buffer tests, update docs by @Cipher208 in #19
• chore: add MkDocs + Material Theme + MkDocstrings docs site by @Cipher208 in #20
• chore: add workflow_dispatch to docs workflow by @Cipher208 in #21
• fix: test_legacy_plain_json_gets_rotated flaky nonce collision by @Cipher208 in #22
• fix: auth decrypt-first to eliminate nonce collision flakiness by @Cipher208 in #23
• docs: sync stale content — test counts, CI pipeline, decrypt-first by @Cipher208 in #24
• chore: add pip-audit to CI for CVE scanning by @Cipher208 in #25
• fix: resolve CI merge conflict by @Cipher208 in #26
• chore: replace markdown issue templates with YAML forms by @Cipher208 in #27
• chore: security hardening — CodeQL, Docker non-root, push protection by @Cipher208 in #28
• fix: resolve codeql merge conflict by @Cipher208 in #29
• chore: CI concurrency + pip cache, CORS restrict to localhost by @Cipher208 in #30
• fix: resolve server.py merge conflict by @Cipher208 in #31

New Contributors

• @Cipher208 made their first contribution in #2
• @dependabot[bot] made their first contribution in #3

Full Changelog: https://github.com/Cipher208/mcp-ariel-memory/commits/v1.0.0