# Tenets Project Configuration
[project]
name = "tenets"
version = "0.9.3"
description = "MCP server for AI coding assistants — intelligent code context via Model Context Protocol"
authors = [{name = "Tenets Team", email = "team@tenets.dev"}]
readme = {file = "README.md", content-type = "text/markdown"}
license = {text = "MIT"}
requires-python = ">=3.9"
keywords = ["mcp", "model-context-protocol", "ai", "llm", "code-analysis", "prompt-engineering", "developer-tools", "context-management", "cursor", "claude", "ai-coding-assistant"]
# PyPI classifiers
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Topic :: Software Development :: Libraries :: Python Modules",
"Topic :: Software Development :: Quality Assurance",
"Topic :: Software Development :: Code Generators",
"Topic :: Scientific/Engineering :: Artificial Intelligence",
]
# Core dependencies
dependencies = [
"click>=8.1.0",
"typer>=0.9.0",
"rich>=13.0.0",
"pydantic>=2.0.0",
"pydantic-settings>=2.0.0",
"httpx>=0.25.0",
"gitpython>=3.1.0",
"pathspec>=0.11.0",
"chardet>=5.0.0",
"aiofiles>=23.0.0",
"tqdm>=4.65.0",
"psutil>=5.9.0",
"PyYAML>=6.0",
"numpy>=1.24.0", # For TF-IDF and ranking calculations
]
[project.urls]
Homepage = "https://github.com/jddunn/tenets"
Documentation = "https://tenets.dev/docs"
Repository = "https://github.com/jddunn/tenets"
Issues = "https://github.com/jddunn/tenets/issues"
Changelog = "https://github.com/jddunn/tenets/blob/main/CHANGELOG.md"
[project.scripts]
tenets = "tenets.cli.app:app"
tenets-mcp = "tenets.mcp.server:main"
[project.optional-dependencies]
# MCP Server (Model Context Protocol for AI assistants)
mcp = [
"mcp[cli]>=1.0.0",
"sse-starlette>=1.6.0",
"uvicorn>=0.23.0",
"scikit-learn>=1.3.0", # Required for default TextRank summarization
"nltk>=3.8.0", # Required for TextRank
]
# Visualization (graphs, charts)
viz = [
"networkx>=3.0",
"matplotlib>=3.7.0",
"graphviz>=0.20.0",
"plotly>=5.0.0",
"pydot>=1.4.0",
]
# Extra keyword extraction algorithms (optional - core already works fine)
light = [
"rake-nltk>=1.0.6",
"yake>=0.4.8",
"scikit-learn>=1.3.0",
"textstat>=0.7.3",
"nltk>=3.8.0",
]
# Deep learning for semantic search (2GB+ models)
ml = [
"torch>=2.0.0",
"transformers>=4.30.0",
"sentence-transformers>=2.2.0",
"tiktoken>=0.5.0",
"faiss-cpu>=1.7.4",
"openai>=1.0.0",
"anthropic>=0.25.0",
"litellm>=1.0.0",
"huggingface-hub>=0.19.0",
]
# (duplicate viz block removed; merged into the single viz list above)
# Web interface
web = [
"fastapi>=0.100.0",
"uvicorn[standard]>=0.23.0",
"websockets>=11.0",
"jinja2>=3.1.0",
"python-multipart>=0.0.6",
"sse-starlette>=1.6.0",
]
# Database and caching
db = [
"alembic>=1.12.0",
"sqlalchemy>=2.0.0",
"redis>=5.0.0",
"diskcache>=5.6.0", # For disk-based caching
]
# Development dependencies
dev = [
"pytest>=7.4.0",
"pytest-asyncio>=0.21.0",
"pytest-cov>=4.1.0",
"pytest-mock>=3.12.0",
"pytest-timeout>=2.2.0",
"pytest-xdist>=3.3.0",
"hypothesis>=6.82.0",
"faker>=19.0.0",
"freezegun>=1.2.0",
"coverage>=7.3.0",
"coverage-badge>=1.1.0",
"black>=23.0.0",
"isort>=5.12.0",
"ruff>=0.1.0",
"mypy>=1.5.0",
"autoflake>=2.2.0",
"bandit[toml]>=1.7.5",
"safety>=2.3.0",
"pre-commit>=3.4.0",
"mkdocs>=1.5.0",
# Optional: Imaging extras for Material social cards (cairosvg, pillow, etc.)
# Note: Rendering social cards needs native Cairo. Skip locally on Windows
# and enable only in CI or Linux if desired.
"mkdocs-material[imaging]>=9.5.0",
"mkdocs-git-revision-date-localized-plugin>=1.2.0",
"mkdocs-git-authors-plugin>=0.7.0",
"mkdocs-awesome-pages-plugin>=2.9.0",
"mkdocs-section-index>=0.3.0",
"mkdocs-macros-plugin>=0.9.0",
"mkdocs-mermaid2-plugin>=1.1.0",
"mkdocs-jupyter>=0.24.0",
"mkdocs-gen-files>=0.5.0",
"mkdocs-literate-nav>=0.6.0",
"mkdocstrings[python]>=0.24.0",
"mkdocs-autorefs>=1.0.0",
"mkdocs-minify-plugin>=0.8.0",
"mike>=2.0.0",
"build>=1.0.0",
"twine>=4.0.0",
"wheel>=0.41.0",
"commitizen>=3.12.0",
"pyinstaller>=6.0.0",
"pip-tools>=7.3.0",
]
# Test dependencies
test = [
"pytest>=7.4.0",
"pytest-asyncio>=0.21.0",
"pytest-cov>=4.1.0",
"pytest-mock>=3.12.0",
"pytest-timeout>=2.2.0",
"pytest-xdist>=3.3.0",
"hypothesis>=6.92.0",
"responses>=0.24.0",
"faker>=20.0.0",
# Include tiktoken so tokenization tests aren't skipped in core test matrix
"tiktoken>=0.5.0",
]
# Documentation dependencies
docs = [
"mkdocs>=1.5.0",
# Optional: Imaging extras for Material social cards (cairosvg, pillow, etc.)
# Requires native Cairo; safe to omit for local builds.
"mkdocs-material[imaging]>=9.5.0",
"mkdocstrings[python]>=0.23.0",
"mkdocs-minify-plugin>=0.7.0",
"pymdown-extensions>=10.0",
"mkdocs-gen-files>=0.5.0",
"mkdocs-awesome-pages-plugin>=2.9.0",
"mkdocs-literate-nav>=0.6.0",
"mkdocs-section-index>=0.3.0",
"mkdocs-git-revision-date-localized-plugin>=1.2.0",
"mkdocs-redirects>=1.2.0",
"mike>=2.0.0"
]
# All features
all = [
"tenets[light,ml,viz,web,db,mcp]",
]
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.build]
include = [
"tenets/**/*.py",
"tenets/**/*.json",
"tenets/**/*.yaml",
"tenets/**/*.yml",
"tenets/**/*.toml",
"tenets/**/*.html",
"tenets/**/*.css",
"tenets/**/*.js",
"tenets/**/*.txt", # Include stopwords.txt
]
exclude = [
"tests",
"docs",
"*.pyc",
"__pycache__",
]
[tool.black]
line-length = 100
target-version = ['py39']
include = '\.pyi?$'
extend-exclude = '''
/(
\.eggs
| \.git
| \.hg
| \.mypy_cache
| \.tox
| \.venv
| build
| dist
| __pycache__
)/
'''
[tool.isort]
profile = "black"
line_length = 100
multi_line_output = 3
include_trailing_comma = true
force_grid_wrap = 0
use_parentheses = true
ensure_newline_before_comments = true
skip_glob = ["*/migrations/*", "*/venv/*"]
[tool.ruff]
line-length = 100
target-version = "py39"
exclude = [
".bzr",
".direnv",
".eggs",
".git",
".hg",
".mypy_cache",
".nox",
".pants.d",
".ruff_cache",
".svn",
".tox",
".venv",
"__pypackages__",
"_build",
"buck-out",
"build",
"dist",
"node_modules",
"venv",
]
[tool.ruff.lint]
select = [
"E", # pycodestyle errors
"W", # pycodestyle warnings
"F", # pyflakes
"I", # isort
"B", # flake8-bugbear
"C4", # flake8-comprehensions
"UP", # pyupgrade
"ARG", # flake8-unused-arguments
"SIM", # flake8-simplify
"TCH", # flake8-type-checking
"RUF", # ruff-specific rules
"PTH", # flake8-use-pathlib
"ERA", # eradicate
"PD", # pandas-vet
"PGH", # pygrep-hooks
"PL", # pylint
"TRY", # tryceratops
]
ignore = [
"E501", # line too long (handled by black)
"B008", # do not perform function calls in argument defaults
"B905", # zip() without an explicit strict= parameter
"PLR0913", # too many arguments to function call
"TRY003", # Avoid specifying long messages outside the exception class
"UP035", # deprecated typing imports (if you want to keep Python 3.9 compat)
"UP036", # version block considered outdated
]
[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401", "F403"]
"tests/*" = ["ARG", "S101", "PLR2004"]
[tool.mypy]
python_version = "3.9"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
check_untyped_defs = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_no_return = true
warn_unreachable = true
strict_equality = true
strict_concatenate = true
plugins = ["pydantic.mypy"]
[[tool.mypy.overrides]]
module = [
"yake.*",
"sentence_transformers.*",
"tiktoken.*",
"transformers.*",
"faiss.*",
"nltk.*",
"networkx.*",
"plotly.*",
"matplotlib.*",
"graphviz.*",
]
ignore_missing_imports = true
[tool.pytest.ini_options]
minversion = "7.0"
addopts = [
"-ra",
"-q",
"--strict-markers",
"--cov=tenets",
"--cov-branch",
"--cov-report=term-missing",
"--cov-report=xml",
"--cov-report=html",
"--durations=10",
]
testpaths = ["tests"]
python_files = ["test_*.py", "*_test.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
norecursedirs = [
"venv",
".venv",
"Lib",
"lib",
"Scripts",
"bin",
"Include",
"include",
"site-packages",
"build",
"dist",
".git",
".hg",
".mypy_cache",
".pytest_cache",
]
markers = [
"slow: marks tests as slow (deselect with '-m \"not slow\"')",
"integration: marks tests as integration tests",
"unit: marks tests as unit tests",
"requires_git: marks tests that require git",
"requires_ml: marks tests that require ML dependencies",
"requires_viz: marks tests that require visualization dependencies",
"cli: CLI command tests",
"smoke: Quick smoke tests for CI",
]
filterwarnings = [
"ignore::DeprecationWarning",
"ignore::PendingDeprecationWarning",
"ignore::ResourceWarning:coverage",
"ignore::ResourceWarning:_pytest",
"ignore::ResourceWarning:sqlite3",
"ignore::pytest.PytestUnraisableExceptionWarning",
]
[tool.coverage.run]
source = ["tenets"]
branch = true
parallel = true
concurrency = ["thread"]
sigterm = true
omit = [
"*/tests/*",
"*/test_*.py",
"*/__main__.py",
"*/cli/app.py",
# Optional features (users may not install)
"*/viz/*",
# Language analyzers (boilerplate, 18K lines)
"*/core/analysis/implementations/*_analyzer.py",
# Infrastructure utilities
"*/utils/external_sources.py",
"*/utils/multiprocessing.py",
"*/utils/timing.py",
]
[tool.coverage.report]
precision = 2
show_missing = true
skip_covered = false
exclude_lines = [
"pragma: no cover",
"def __repr__",
"if TYPE_CHECKING:",
"raise AssertionError",
"raise NotImplementedError",
"if __name__ == .__main__.:",
"@abstractmethod",
]
[tool.commitizen]
name = "cz_conventional_commits"
version = "0.3.2"
tag_format = "v$version"
version_files = [
"tenets/__init__.py:__version__",
"pyproject.toml:version",
]
update_changelog_on_bump = true
major_version_zero = true
changelog_file = "CHANGELOG.md"
changelog_incremental = true
changelog_start_rev = "v0.1.0"
[tool.commitizen.customize]
bump_pattern = "^(feat|fix|perf|refactor|BREAKING)"
[tool.commitizen.customize.bump_map]
"BREAKING CHANGE" = "MAJOR"
"BREAKING" = "MAJOR"
"feat" = "MINOR"
"fix" = "PATCH"
"perf" = "PATCH"
"refactor" = "PATCH"
[tool.bandit]
exclude_dirs = ["tests", "venv", ".venv", "build", "dist"]
severity = "medium" # Only report medium and high severity issues
[tool.pydocstyle]
convention = "google"
match-dir = "^(?!tests|venv|build|dist).*"
add-ignore = ["D100", "D104"]
