pyproject.toml

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

[project]
name = "claude-cortex"
version = "4.7.0"
description = "Context orchestration CLI with curated agents, rules, skills, and management tools for Claude Code"
authors = [{ name = "Nicholas Ferguson", email = "nick@atlascrew.dev" }]
license = "MIT"
readme = "README.md"
keywords = [
  "AI",
  "claude code",
  "codex",
  "claude",
  "AI augmented development",
  "AI agents",
  "development tools",
  "AI tools",
]
classifiers = [
  "Development Status :: 5 - Production/Stable",
  "Environment :: Console",
  "Intended Audience :: Developers",
  "Topic :: Software Development",
]
requires-python = ">=3.9"
dependencies = [
  "argcomplete>=3.2",
  "rich>=13.0.0",
  "textual>=0.47.0",
  "PyYAML>=6.0.0",
  "psutil>=5.9.0",
  "jsonplate>=0.0.1",
  "jsonschema>=4.25.1",
]
[project.urls]
Issues = "https://github.com/NickCrew/claude-cortex/issues"
Repository = "https://github.com/NickCrew/claude-cortex"
Documentation = "https://cortex.atlascrew.dev"
Changelog = "https://github.com/NickCrew/claude-cortex/blob/main/CHANGELOG.md"
Homepage = "https://atlascrew.dev"

[project.optional-dependencies]
# AI Intelligence features
ai = [
  "fastembed>=0.7.4", # Semantic similarity matching
  "numpy>=1.24.0",    # Required by fastembed
]
llm = [
  "anthropic>=0.18.0", # Optional LLM-powered recommendations
]
dashboard = ["fastapi>=0.100.0", "uvicorn>=0.20.0"]
# Development dependencies
dev = [
  "pytest>=7.4.0",
  "pytest-cov>=4.1.0",
  "pytest-mock>=3.12.0",
  "mypy>=1.7.0",
  "types-PyYAML>=6.0.0",
  "types-psutil>=5.9.0",
  "black>=23.0.0",
  "PyYAML>=6.0.0",
  "build>=1.0.0",
  "python-semantic-release>=9.0.0",
]
# All optional features
all = [
  "fastembed>=0.7.4",
  "numpy>=1.24.0",
  "anthropic>=0.18.0",
  "fastapi>=0.100.0",
  "uvicorn>=0.20.0",
]

[project.scripts]
cortex = "claude_ctx_py.cli:main"
cortex-minimal = "claude_ctx_py.minimal_cli:main"

[tool.setuptools]
include-package-data = true

[tool.setuptools.packages.find]
where = ["."]
include = ["claude_ctx_py*"]

[tool.setuptools.data-files]
# Regenerate with: cortex dev manpages
# Validate with:   cortex dev validate-manpages
"share/man/man1" = [
  "docs/reference/cortex.1",
  "docs/reference/cortex-agent.1",
  "docs/reference/cortex-completions.1",
  "docs/reference/cortex-dev.1",
  "docs/reference/cortex-docs.1",
  "docs/reference/cortex-export.1",
  "docs/reference/cortex-git.1",
  "docs/reference/cortex-hooks.1",
  "docs/reference/cortex-install.1",
  "docs/reference/cortex-mcp.1",
  "docs/reference/cortex-notes.1",
  "docs/reference/cortex-rules.1",
  "docs/reference/cortex-skills.1",
  "docs/reference/cortex-suggest.1",
  "docs/reference/cortex-status.1",
  "docs/reference/cortex-statusline.1",
  "docs/reference/cortex-tmux.1",
  "docs/reference/cortex-tui.1",
  "docs/reference/cortex-uninstall.1",
]
# Root-level docs
"share/claude-cortex/docs" = [
  "site/index.md",
  "CHANGELOG.md",
  "CREDITS.md",
  "LICENSE",
]
# Getting started
"share/claude-cortex/docs/getting-started" = [
  "site/getting-started/index.md",
  "site/getting-started/installation.md",
  "site/getting-started/configuration.md",
  "site/getting-started/quick-start.md",
]
# Guides
"share/claude-cortex/docs/guides" = [
  "site/guides/index.md",
  "site/guides/agent-activation.md",
  "site/guides/agent-loops.md",
  "site/guides/ai-intelligence.md",
  "site/guides/cli.md",
  "site/guides/doc-health-audit.md",
  "site/guides/docs-commands.md",
  "site/guides/export.md",
  "site/guides/git-workflow.md",
  "site/guides/hooks.md",
  "site/guides/llm-consult.md",
  "site/guides/notes.md",
  "site/guides/planning.md",
  "site/guides/review.md",
  "site/guides/rules.md",
  "site/guides/skills.md",
  "site/guides/tmux-workflow.md",
  "site/guides/tui.md",
]
# Tutorials
"share/claude-cortex/docs/tutorials" = [
  "site/tutorials/index.md",
  "site/tutorials/bug-fix-workflow.md",
  "site/tutorials/export-context.md",
  "site/tutorials/feature-workflow.md",
  "site/tutorials/skill-recommendations.md",
  "site/tutorials/tui-first-20-minutes.md",
  "site/tutorials/watch-mode.md",
]
# Reference
"share/claude-cortex/docs/reference" = [
  "site/reference/index.md",
  "site/reference/agents.md",
  "site/reference/commands.md",
  "site/reference/configuration.md",
  "site/reference/skills.md",
]


[tool.mypy]
python_version = "3.9"
strict = true
warn_return_any = true
warn_unused_configs = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_no_return = true
warn_unreachable = true
strict_equality = true
show_error_codes = true
show_column_numbers = true
pretty = true

[[tool.mypy.overrides]]
module = "yaml.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "psutil.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "claude_ctx_py.activator"
disallow_untyped_calls = false

[tool.pytest.ini_options]
minversion = "7.0"
testpaths = ["tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
addopts = [
  "-v",
  "--strict-markers",
  "--tb=short",
  "--cov=claude_ctx_py",
  "--cov-report=term-missing",
  "--cov-report=html",
  "--cov-report=xml",
  "--cov-branch",
]
markers = [
  "unit: Unit tests for individual components",
  "integration: Integration tests for CLI and workflows",
  "slow: Tests that take longer to run",
  "fast: Tests that run quickly (< 1 second)",
  "tui: Tests for TUI components",
  "cli: Tests for CLI interface",
  "core: Tests for core functionality",
  "intelligence: Tests for AI/intelligence features",
  "smoke: Smoke tests for critical paths",
  "regression: Regression tests for bug fixes",
  "requires_yaml: Tests that require PyYAML to be installed",
]

[tool.coverage.run]
source = ["claude_ctx_py"]
omit = ["*/tests/*", "*/__pycache__/*", "*/site-packages/*"]

[tool.coverage.report]
# Progressive coverage target (current: 15%, target: 80%)
# Phase 1: 15% (Week 1) - Baseline + buffer
# Phase 2: 30% (Week 2) - Core modules
# Phase 3: 50% (Week 3) - Major features
# Phase 4: 65% (Week 4) - Comprehensive
# Phase 5: 80% (Future) - Target coverage
fail_under = 15
precision = 2
show_missing = true
skip_covered = false
exclude_lines = [
  "pragma: no cover",
  "def __repr__",
  "raise AssertionError",
  "raise NotImplementedError",
  "if __name__ == .__main__.:",
  "if TYPE_CHECKING:",
  "@abstractmethod",
  "@abc.abstractmethod",
]

[tool.coverage.html]
directory = "htmlcov"

[tool.black]
line-length = 88
target-version = ["py39"]
include = '\.pyi?$'
extend-exclude = '''
/(
    \.git
  | \.mypy_cache
  | \.pytest_cache
  | \.venv
  | htmlcov
)/
'''

[tool.semantic_release]
version_toml = ["pyproject.toml:project.version"]
version_variables = []
build_command = "python -m build"
dist_path = "dist/"
upload_to_vcs_release = true
upload_to_pypi = true
upload_to_repository = true
remove_dist = false
patch_without_tag = false
major_on_zero = true
allow_zero_version = true
commit_parser = "angular"
logging_use_named_masks = false
tag_format = "v{version}"

[tool.semantic_release.branches.main]
match = "main"
prerelease = false

[tool.semantic_release.changelog]
template_dir = "templates"
changelog_file = "CHANGELOG.md"
exclude_commit_patterns = []

[tool.semantic_release.changelog.environment]
block_start_string = "{%"
block_end_string = "%}"
variable_start_string = "{{"
variable_end_string = "}}"
comment_start_string = "{#"
comment_end_string = "#}"
trim_blocks = false
lstrip_blocks = false
newline_sequence = "\n"
keep_trailing_newline = false
extensions = []
autoescape = true

[tool.semantic_release.commit_author]
env = "GIT_COMMIT_AUTHOR"
default = "semantic-release <semantic-release>"

[tool.semantic_release.commit_parser_options]
allowed_tags = [
  "build",
  "chore",
  "ci",
  "docs",
  "feat",
  "fix",
  "perf",
  "style",
  "refactor",
  "test",
]
minor_tags = ["feat"]
patch_tags = ["fix", "perf"]

[tool.semantic_release.remote]
name = "origin"
type = "github"
ignore_token_for_push = false

[tool.semantic_release.publish]
dist_glob_patterns = ["dist/*"]
upload_to_vcs_release = true

[dependency-groups]
dev = ["pytest>=8.4.2"]