Metadata-Version: 2.4
Name: mneme-core
Version: 2.0.0
Summary: Vault-native memory engine for Claude Code. FTS5 BM25, RRF-ready retrieval, gated Graphiti KG, and adaptive context tooling.
Project-URL: Homepage, https://github.com/TheGoatPsy/mneme
Project-URL: Documentation, https://github.com/TheGoatPsy/mneme/tree/main/docs
Project-URL: Repository, https://github.com/TheGoatPsy/mneme.git
Project-URL: Issues, https://github.com/TheGoatPsy/mneme/issues
Project-URL: Changelog, https://github.com/TheGoatPsy/mneme/blob/main/CHANGELOG.md
Author: Onour Impram
License: MIT
Keywords: claude-code,fts5,graphiti,knowledge-graph,markdown,mcp,memory,rrf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: >=3.11
Requires-Dist: click<9,>=8.1
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: structlog<25,>=24.1
Provides-Extra: compression
Requires-Dist: anthropic<1,>=0.28; extra == 'compression'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.2; extra == 'dev'
Requires-Dist: ruff>=0.4.7; extra == 'dev'
Requires-Dist: testcontainers>=4.0; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: anthropic<1,>=0.28; extra == 'full'
Requires-Dist: graphiti-core<1,>=0.3; extra == 'full'
Requires-Dist: neo4j<6,>=5.21; extra == 'full'
Requires-Dist: onnxruntime<2,>=1.18; extra == 'full'
Provides-Extra: standard
Requires-Dist: onnxruntime<2,>=1.18; extra == 'standard'
Description-Content-Type: text/markdown

# mneme-core

Python core for [mneme](https://github.com/TheGoatPsy/mneme): vault-native memory for Claude Code, also usable from Codex and any MCP client. mneme is Claude-Code-native by origin and client-neutral at the core.

This package provides:

- FTS5 BM25 full-text indexer with language-aware normalization (Turkish casefold module included as utility).
- RRF-ready retrieval pipeline at `k=60`, with FTS5 shipped and optional backends injectable by callers.
- Graphiti bi-temporal knowledge graph adapter, gated by the full profile and local Neo4j.
- Roadmap dense embedding adapter. The v1.0 standard profile reserves the runtime slot but does not ship packaged LEANN retrieval.
- Background compression pipeline with 4-D rubric (Accuracy, Depth, Context, Continuity) and cost cap ledger.
- Adaptive Context Layer: `distill.shell_compress`, `distill.injection_dedup`, `distill.adaptive_topk`, `distill.compressed_format`, and the `mneme audit` CLI.

## Installation

```bash
pip install mneme-core
```

For development:

```bash
pip install -e ".[dev]"
```

## Quality Gates

This package targets Python 3.11+ and passes `ruff` lint plus `mypy --strict`. Test coverage minimum is 80 percent for business logic.

## License

MIT. See LICENSE in the repository root.
