pyproject.toml

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

# ---------------------------------------------------------------------------
# Project metadata
# ---------------------------------------------------------------------------

[project]
name = "contextgo"
dynamic = ["version"]
description = "Local-first context & memory runtime for multi-agent AI coding teams"
readme = "README.md"
license = "AGPL-3.0-only"
requires-python = ">=3.10"
authors = [
    { name = "Dunova", email = "contact@dunova.io" },
]
maintainers = [
    { name = "Dunova", email = "contact@dunova.io" },
]
keywords = [
    "ai",
    "context",
    "memory",
    "local-first",
    "developer-tools",
    "multi-agent",
    "llm",
    "coding-assistant",
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: GNU Affero General Public License v3",
    "Natural Language :: English",
    "Operating System :: OS Independent",
    "Operating System :: POSIX",
    "Operating System :: POSIX :: Linux",
    "Operating System :: MacOS",
    "Operating System :: Microsoft :: Windows",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3 :: Only",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: Implementation :: CPython",
    "Topic :: Software Development",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Software Development :: Build Tools",
    "Topic :: System :: Logging",
    "Topic :: Utilities",
    "Typing :: Typed",
]

# Core runtime has zero mandatory third-party dependencies.
# httpx is available as an optional extra for remote sync paths.
dependencies = []

[project.optional-dependencies]
remote = ["httpx>=0.27"]
vector = ["model2vec>=0.4.0", "bm25s>=0.2.0", "numpy>=1.24"]
dev = [
    "pytest>=8.0",
    "pytest-cov>=5.0",
    "pytest-asyncio>=0.23",
    "ruff>=0.4",
    "bandit>=1.8",
    "safety>=3.3",
    "mypy>=1.10",
    "numpy>=1.24",
    "build>=1.2",
    "twine>=5.0",
]
all = [
    "contextgo[remote]",
    "contextgo[vector]",
]

[project.scripts]
contextgo = "contextgo.context_cli:main"

[project.urls]
Homepage = "https://github.com/dunova/ContextGO"
Documentation = "https://github.com/dunova/ContextGO/tree/main/docs"
Repository = "https://github.com/dunova/ContextGO"
"Bug Tracker" = "https://github.com/dunova/ContextGO/issues"
Changelog = "https://github.com/dunova/ContextGO/blob/main/.github/CHANGELOG.md"
Security = "https://github.com/dunova/ContextGO/blob/main/.github/SECURITY.md"

# ---------------------------------------------------------------------------
# Hatch — version and build
# ---------------------------------------------------------------------------

[tool.hatch.version]
path = "VERSION"
pattern = "(?P<version>[0-9]+\\.[0-9]+\\.[0-9]+.*)"

[tool.hatch.build.targets.wheel]
packages = ["src/contextgo"]
exclude = [
    "**/__pycache__",
    "**/*.pyc",
    "**/import_memories.py",
]

[tool.hatch.build.targets.wheel.force-include]
"src/contextgo/py.typed" = "contextgo/py.typed"
"src/contextgo/data/noise_markers.json" = "contextgo/data/noise_markers.json"

[tool.hatch.build.targets.sdist]
include = [
    "/src",
    "/tests",
    "/scripts",
    "/native",
    "/docs",
    "/docs/benchmarks",
    "/docs/templates",
    "/VERSION",
    "/README.md",
    "/.github/CHANGELOG.md",
    "/.github/CONTRIBUTING.md",
    "/.github/SECURITY.md",
    "/LICENSE",
]

# ---------------------------------------------------------------------------
# Ruff — linter and formatter
# ---------------------------------------------------------------------------

[tool.ruff]
target-version = "py310"
line-length = 120

[tool.ruff.lint]
select = ["E", "F", "W", "I", "UP", "B", "SIM", "C4", "PIE", "RET", "TID"]
ignore = [
    "E501",   # line length — enforced via formatter, not linter
]
unfixable = ["B"]  # keep B-violations visible; fix manually

[tool.ruff.lint.per-file-ignores]
"tests/test_*.py" = ["SIM117", "SIM105", "E741", "E402"]

[tool.ruff.lint.isort]
known-first-party = ["contextgo"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false

# ---------------------------------------------------------------------------
# pytest
# ---------------------------------------------------------------------------

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
addopts = [
    "--cov=src/contextgo",
    "--cov-report=term-missing",
    "--cov-report=xml",
    "--cov-fail-under=97",
    "-v",
]

# ---------------------------------------------------------------------------
# Coverage
# ---------------------------------------------------------------------------

[tool.coverage.run]
source = ["src/contextgo"]
omit = ["tests/test_*.py", "tests/*_test.py", "src/contextgo/__main__.py"]
branch = true

[tool.coverage.report]
show_missing = true
skip_covered = false
precision = 1
fail_under = 86
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "raise NotImplementedError",
    "\\.\\.\\.",
]
exclude_also = [
    # Dual-import fallback pattern: try bare import, fallback to relative
    "except ImportError:",
    "from \\. import",
]

# ---------------------------------------------------------------------------
# Bandit — security scanner
# ---------------------------------------------------------------------------

[tool.bandit]
exclude_dirs = ["tests"]
skips = ["B101", "B310", "B311", "B404", "B603", "B607", "B608"]
# B101: assert; B310: url open; B311: random (non-crypto); B404: subprocess import
# B603: subprocess w/o shell; B607: partial path; B608: SQL string (parameterized ?)

# ---------------------------------------------------------------------------
# Mypy
# ---------------------------------------------------------------------------

[tool.mypy]
python_version = "3.10"
strict = false
warn_return_any = false
warn_unused_ignores = false
ignore_missing_imports = true
disable_error_code = ["no-redef", "assignment", "attr-defined", "operator", "misc", "return-value"]