pyproject.toml

[project]
name = "advanced-memory-mcp"
version = "1.11.0"
description = "Comprehensive research and knowledge platform with web search, GitHub trawling, arXiv academic research, TV Tropes narrative analysis, document ingestion, RAG vector search, and research-driven skill creation"
readme = "README.md"
requires-python = ">=3.12"
license = { text = "MIT" }
authors = [
    { name = "Sandra Schipal", email = "sandraschipal@gmail.com" }
]
dependencies = [
    "sqlalchemy>=2.0.0",
    "pyyaml>=6.0.1",
    "typer>=0.9.0",
    "aiosqlite>=0.20.0",
    "greenlet>=3.1.1",
    "pydantic[email,timezone]>=2.10.3",
    "icecream>=2.1.3",
    "mcp>=1.2.0",
    "pydantic-settings>=2.6.1",
    "loguru>=0.7.3",
    "pyright>=1.1.390",
    "markdown-it-py>=3.0.0",
    "python-frontmatter>=1.1.0",
    "rich>=13.9.4",
    "unidecode>=1.3.8",
    "dateparser>=1.2.0",
    "watchfiles>=1.0.4",
    "fastapi[standard]>=0.115.8",
    "alembic>=1.14.1",
    "mako>=1.3.0",
    "pillow>=11.1.0",
    "pybars3>=0.9.7",
    "fastmcp[code-mode,tasks]>=3.4.4,<4",
    "pyjwt>=2.10.1",
    "python-dotenv>=1.1.0",
    "pytest-aio>=1.9.0",
    "markdown>=3.9",
    "pyyaml>=6.0",
    "types-pyyaml>=6.0.12.20250915",
    "types-markdown>=3.9.0.20250906",
    "defusedxml>=0.7.1",
    "starlette>=0.47.2",
    "regex>=2025.2.10",
    "pypandoc>=1.13",
    "fpdf2>=2.7.0",
    "requests>=2.31.0",
    "httpx>=0.27.0",
    "gitpython>=3.1.40",
    "wikipedia-api>=0.6.0",
    "arxiv>=2.1.0",
    "pypdf>=3.17.0",
    "pdfplumber>=0.10.0",
    "beautifulsoup4>=4.12.0",
    "lxml>=5.1.0",
    "pathspec>=0.12.0", # .gitignore pattern matching for repo export
    "aiohttp>=3.9.0", # Async HTTP for web research
    "lancedb>=0.17.0", # Vector database for RAG
    "fastembed-gpu>=0.4.0", # Fast local text embeddings (GPU build - depends on onnxruntime-gpu, not plain onnxruntime, to avoid colliding with this project's own onnxruntime-gpu pin)
    "PyMuPDF>=1.23.0", # PDF text extraction for research
    "cryptography>=45.0.5",
    "psutil>=6.1.1",
    "nvidia-ml-py>=12.560.30",
    "prefab-ui>=0.19.0",
]

[project.optional-dependencies]
voice = [
    "kokoro>=0.9.4",             # Soulful Text-to-speech (speak)
    "faster-whisper>=1.2.1",     # High-performance Speech-to-text (dictate)
    "onnxruntime-gpu>=1.23.2",   # GPU acceleration for STT/TTS
    "sounddevice>=0.5.2",        # Audio recording
    "soundfile>=0.13.1",         # Audio file handling
    "numpy>=1.26.4",             # Array processing
]
plex = [
    "plexapi>=4.15.0",    # Plex Media Server API (music control)
]

[project.urls]
Homepage = "https://github.com/sandraschi/advanced-memory-mcp"
Repository = "https://github.com/sandraschi/advanced-memory-mcp"
Documentation = "https://github.com/sandraschi/advanced-memory-mcp#readme"

[project.scripts]
advanced-memory = "advanced_memory.cli.main:app"
am = "advanced_memory.cli.main:app"
release = "scripts.release:main"
am-skill-creator = "advanced_memory.services.skill_creator.cli:main"

[build-system]
requires = ["hatchling", "uv-dynamic-versioning>=0.7.0"]
build-backend = "hatchling.build"

[tool.pytest.ini_options]
pythonpath = ["src", "tests"]
# Default: capture stdout/stderr (avoids megabytes of loguru DEBUG on green runs). Use ``pytest -s`` when you need live prints.
addopts = "-v --cov=advanced_memory --cov-report=term-missing --cov-fail-under=40"
testpaths = ["tests"]
asyncio_mode = "strict"
markers = [
    "unit: fast unit tests",
    "integration: integration tests (may need live services)",
    "slow: slow tests (deselect with '-m \"not slow\"')",
    "serial: tests that must run serially",
]
filterwarnings = [
    "ignore::DeprecationWarning:.*datetime.datetime.utcnow",
    "ignore::DeprecationWarning:.*datetime adapter",
    "ignore::pytest.PytestUnraisableExceptionWarning",
    "ignore::RuntimeWarning:.*coroutine.*was never awaited",
]

[dependency-groups]
dev = [
    "gevent>=24.11.1",
    "icecream>=2.1.3",
    "pytest>=8.3.4",
    "pytest-cov>=4.1.0",
    "pytest-mock>=3.12.0",
    "pytest-asyncio>=0.24.0",
    "pytest-xdist>=3.0.0",
    "ruff==0.16.0",
    "mypy>=1.8.0",
    "black>=24.0.0",
    "isort>=5.13.0",
    "bandit>=1.7.0",
    "safety>=3.0.0",
    "pre-commit>=3.6.0",
    "types-setuptools>=69.0.0",
    "build>=1.0.0",
    "twine>=5.0.0",
    "detect-secrets>=1.5.0",
]

[tool.hatch.version]
source = "uv-dynamic-versioning"

[tool.uv-dynamic-versioning]
vcs = "git"
style = "pep440"
bump = true
fallback-version = "1.6.1"

[tool.hatch.build.targets.wheel]
packages = ["src/advanced_memory"]

[tool.hatch.build.targets.wheel.force-include]
"zettelkasten" = "advanced_memory/zettelkasten"

[tool.pyright]
include = ["src/"]
exclude = ["**/__pycache__"]
ignore = ["test/"]
defineConstant = { DEBUG = true }
reportMissingImports = "error"
reportMissingTypeStubs = false
pythonVersion = "3.11"

[tool.mypy]
python_version = "3.11"
strict = true
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
check_untyped_defs = true
disallow_untyped_decorators = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_no_return = true
warn_unreachable = true
strict_equality = true
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = [
    "alembic.*",
    "fastmcp.*",
    "uv.*",
    "mcp.*",
    "watchfiles.*",
    "rich.*",
    "typer.*",
    "loguru.*",
    "pydantic.*",
    "sqlalchemy.*",
    "aiosqlite.*",
    "markdown_it.*",
    "frontmatter.*",
    "unidecode.*",
    "dateparser.*",
    "pillow.*",
    "pybars3.*",
    "pyjwt.*",
    "dotenv.*",
    "pytest.*",
    "bandit.*",
    "safety.*",
    "semgrep.*",
]
ignore_missing_imports = true



[tool.coverage.run]
concurrency = ["thread"]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "if self.debug:",
    "if settings.DEBUG",
    "raise AssertionError",
    "raise NotImplementedError",
    "if 0:",
    "if __name__ == .__main__.:",
    "class .*\\bProtocol\\):",
    "@(abc\\.)?abstractmethod",
]

# Exclude specific modules that are difficult to test comprehensively
omit = [
    "*/external_auth_provider.py",  # External HTTP calls to OAuth providers
    "*/supabase_auth_provider.py",  # External HTTP calls to Supabase APIs
    "*/watch_service.py",           # File system watching - complex integration testing
    "*/background_sync.py",         # Background processes
    "*/cli/main.py",               # CLI entry point
    "*/services/migration_service.py", # Complex migration scenarios
]

[tool.logfire]
ignore_no_config = true

[tool.ruff]
line-length = 120
target-version = "py312"
# PyInstaller spec files are packaging DSL (undefined globals by design),
# not importable modules — never lint them (2026-09-19: ruff loop on commit).
# temp-anthropic-*/scratch hold vendored course notebooks and throwaway probes,
# not repo source — just lint must stay green without touching them.
exclude = ["*.spec", "temp-anthropic-courses", "temp-anthropic-skills", "scratch"]

[tool.ruff.lint]
select = ["E", "F", "W", "I", "B", "S", "UP", "RUF"]
ignore = ["S101", "B008", "S108", "S603", "S607",  "RUF001", "E501", "S101", "B008", "S108", "S603", "S607",  "RUF001", "E501", "RUF012", "B904", "S606", "S608", "E402", "S324",  "RUF034", "F401", "S605", "S104", "S314", "RUF002", "RUF003", "S106", "B904", "S606", "S608", "E402", "S324",  "RUF034", "F401", "S605", "S104", "S314", "RUF002", "RUF003"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"