pyproject.toml

[build-system]
requires = ["setuptools>=68.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "attune-author"
version = "0.14.2"
description = "Documentation authoring and maintenance for the attune ecosystem — generate, maintain, and validate help content with AI assistance."
readme = {file = "README.md", content-type = "text/markdown"}
requires-python = ">=3.10"
license = {file = "LICENSE"}
authors = [
    {name = "Patrick Roebuck", email = "admin@smartaimemory.com"}
]
keywords = [
    "documentation",
    "authoring",
    "help-system",
    "templates",
    "jinja2",
    "ai",
    "claude",
    "attune",
    "staleness-detection",
    "doc-generation",
]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: Apache Software License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Topic :: Documentation",
    "Topic :: Software Development :: Libraries",
    "Topic :: Text Processing :: Markup :: Markdown",
]
dependencies = [
    "jinja2>=3.1.0",
    "python-frontmatter>=1.0.0",
    "pyyaml>=6.0",
]

[project.optional-dependencies]
ai = ["anthropic>=0.40.0"]
# RAG-grounded authoring. When installed, `attune-author
# generate` consults attune-rag for relevant existing
# templates before generating new ones (on by default,
# opt-out via --no-rag or ATTUNE_AUTHOR_RAG=0). Optional
# so authors who don't want the dep avoid it. Lazy-imported
# inside attune_author.rag_hook; core import is unaffected.
rag = ["attune-rag>=0.1.0,<0.3"]
plugin = [
    "mcp>=0.9.0",
    "anthropic>=0.40.0",
]
rich = ["rich>=13.0.0"]
dev = [
    "pytest>=7.0",
    "pytest-asyncio>=0.21,<2.0",  # required for @pytest.mark.asyncio in tests/test_mcp_handlers_integration.py
    "pytest-cov>=4.0",
    "syrupy>=4.0",
    "ruff>=0.4.0",
    "black>=24.0",
    "mcp>=0.9.0",
    "anthropic>=0.40.0",
    # Required for the help.* orchestration command tests (the
    # commands themselves lazy-import attune_help at runtime — see
    # commands/help.py — so this stays a dev/test-only dep, not a
    # runtime one).
    "attune-help>=0.10.0",
    # Release tooling
    "build>=1.0",
    "twine>=5.0",
]

[project.scripts]
attune-author = "attune_author.cli:main"
attune-author-mcp = "attune_author.mcp.server:main"

[project.urls]
Homepage = "https://github.com/Smart-AI-Memory/attune-author"
Repository = "https://github.com/Smart-AI-Memory/attune-author"
Documentation = "https://github.com/Smart-AI-Memory/attune-author/blob/main/README.md"
Changelog = "https://github.com/Smart-AI-Memory/attune-author/blob/main/CHANGELOG.md"
Issues = "https://github.com/Smart-AI-Memory/attune-author/issues"

[tool.uv.sources]
attune-help = { path = "../attune-help", editable = true }

[tool.setuptools.packages.find]
where = ["src"]

[tool.setuptools.package-data]
"attune_author" = ["meta_templates/**/*.j2"]

[tool.ruff]
line-length = 100

[tool.ruff.lint]
select = ["E", "F", "W", "I", "UP", "BLE"]

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-ra -m 'not live'"
asyncio_mode = "auto"  # pytest-asyncio: auto-collect @pytest.mark.asyncio functions
markers = [
    "live: opt-in tests that hit the live Anthropic API. Skipped by default; require ANTHROPIC_API_KEY and any test-specific env flags.",
]

[tool.coverage.run]
source = ["attune_author"]
branch = true
omit = ["*/tests/*", "*/conftest.py"]

# Faithfulness judge (Phase 3) — opt-in. Scores polished docs
# against source. See docs/specs/polish-fact-check/.
[tool.attune-author.fact-check.faithfulness]
enabled = true
threshold = 0.95
budget_per_file_usd = 0.10
model = "claude-haiku-4-5-20251001"

[tool.coverage.report]
show_missing = true
skip_covered = false
fail_under = 85
exclude_lines = [
    "pragma: no cover",
    "raise NotImplementedError",
    "if TYPE_CHECKING:",
    "if __name__ == .__main__.:",
]