pyproject.toml

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "remember"
version = "0.17.2"
description = "Open memory infrastructure for AI agents."
readme = "README.md"
requires-python = ">=3.12"
license = "Apache-2.0"
license-files = ["LICENSE"]
authors = [
    { name = "WriteIt.ai s.r.o.", email = "info@writeit.ai" },
]
keywords = [
    "ai",
    "agents",
    "memory",
    "knowledge",
    "evidence",
    "bitemporal",
]
classifiers = [
    "Development Status :: 2 - Pre-Alpha",
    "Intended Audience :: Developers",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Typing :: Typed",
]
dependencies = [
    "httpx>=0.28.1",
    "pydantic>=2.11",
    "pydantic-settings>=2.10",
]

[project.optional-dependencies]
# The watched-directory connector uses only the standard library. Other
# connector extras are added with their adapters, rather than speculatively.
connectors-watched-directory = []
# K ships as repository-native data in Phase 6; this names its install surface.
k = []
benchmark = [
    "google-auth>=2.39",
    "google-cloud-storage>=3.4,<4",
    "nltk>=3.9",
    "openai-codex==0.147.0",
    "pyyaml>=6.0",
    "regex>=2024.11.6",
]
observability = [
    "langfuse>=4.14.1,<5",
    "opentelemetry-exporter-otlp-proto-http>=1.44.0",
    "opentelemetry-sdk>=1.44.0",
    "sentry-sdk==2.66.1",
]

[project.scripts]
remember = "remember.cli:main"

[project.urls]
Homepage = "https://remember.dev"
Documentation = "https://remember.dev/docs"
Repository = "https://github.com/writeitai/remember-stack"
Issues = "https://github.com/writeitai/remember-stack/issues"

[dependency-groups]
server = [
    "alembic>=1.16",
    "boto3>=1.42",
    "defusedxml>=0.7",
    "fastapi>=0.139.2",
    "markdown-it-py>=4.2.0",
    "markitdown[docx,pptx,xlsx]>=0.1.6",
    "onnxruntime>=1.24.1; python_version >= '3.14'",
    "openpyxl>=3.1.5",
    "pglast>=8.4,<9",
    "pillow>=10.4",
    "psycopg[binary]>=3.2",
    "pyarrow>=25.0.0",
    "pyjwt[crypto]>=2.10",
    "pyreadstat>=1.3",
    "pypdfium2>=4.30",
    "python-pptx>=1.0",
    "sqlalchemy>=2.0",
    "uvicorn>=0.37",
    "xlrd>=2.0.1",
]
dev = [
    {include-group = "server"},
    "google-auth>=2.39",
    "google-cloud-storage>=3.4,<4",
    "import-linter>=2.13",
    "jsonschema>=4.23",
    "nltk>=3.9",
    "openai-codex==0.147.0",
    "pydantic-settings>=2.10",
    "pyyaml>=6.0",
    "pyright>=1.1",
    "pytest>=8.3",
    "pytest-asyncio>=0.25",
    "pytest-cov>=6.0",
    "ruff>=0.4",
    "regex>=2024.11.6",
]

[tool.uv]
required-version = "==0.12.6"

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

# Ruff config copied from the writeitai house style (team-harness / loopy-loop).
[tool.ruff]
src = ["src", "benchmarks"]
target-version = "py312"
line-length = 88

[tool.ruff.format]
skip-magic-trailing-comma = true

[tool.ruff.lint]
extend-select = ["I", "B", "A", "ERA", "TID251"]

# All configuration goes through pydantic-settings; secrets are SecretStr/SecretBytes
# (requirements_v3.md §Code). Env vars are read in exactly one place — a BaseSettings
# class — never ad hoc. Tests set env via pytest's monkeypatch.setenv, which is not banned.
[tool.ruff.lint.flake8-tidy-imports.banned-api]
"os.environ".msg = "Read config via pydantic-settings (BaseSettings), not os.environ (requirements §Code)."
"os.getenv".msg = "Read config via pydantic-settings (BaseSettings), not os.getenv (requirements §Code)."
"os.putenv".msg = "Do not mutate the process environment; pass typed settings instead (requirements §Code)."

[tool.ruff.lint.isort]
case-sensitive = false
force-single-line = true
force-sort-within-sections = true
known-first-party = ["rememberstack", "remember"]
order-by-type = false
relative-imports-order = "closest-to-furthest"
section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]

# Deliberate deviation from the team-harness/loopy-loop template: they run pyright in
# "basic" mode with ~20 report* checks disabled. This is a data-integrity system (enums,
# validity windows, adjudication outcomes), so library code runs "standard" (NOT strict —
# the noisy reportUnknown* family is off) with no checks disabled.
#
# Relax-with-receipts rule: any future report*=false here MUST carry a one-line reason
# comment and come from observed friction on real code, never pre-emptively. Loosening
# later is a one-line change; tightening later means fixing accumulated violations.
[tool.pyright]
pythonVersion = "3.12"
typeCheckingMode = "standard"
include = ["src", "benchmarks"]
extraPaths = ["src", ".", "scripts"]
exclude = ["**/.venv", "**/virtualenvs", "tmp/"]

# Test code has different ergonomics (poking internals, monkeypatching) — relaxed
# per-directory, so src/rememberstack stays at full standard.
[[tool.pyright.executionEnvironments]]
root = "src/tests"
reportPrivateUsage = false

[tool.pytest.ini_options]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"
pythonpath = ["src", "."]
testpaths = ["src/tests"]

[tool.coverage.run]
source = ["src/rememberstack", "src/remember"]
branch = true
relative_files = true # required by the coverage-comment action

[tool.coverage.report]
show_missing = true
precision = 1