pyproject.toml

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

[project]
name = "agents-shipgate"
version = "1.0.0a1"
description = "The deterministic merge gate for AI-generated agent capability changes. Agent release readiness for tool-using AI agents. CLI + GitHub Action. Scans MCP, OpenAPI, OpenAI Agents SDK, Anthropic, Google ADK, LangChain, CrewAI, OpenAI API, Codex config, Codex plugin, n8n."
readme = "README.md"
requires-python = ">=3.12"
license = "Apache-2.0"
authors = [
  { name = "Agents Shipgate Contributors" }
]
keywords = [
  "agent",
  "ai-agent",
  "agent-release",
  "agent-release-readiness",
  "ai-agent-cicd",
  "tool-use",
  "tool-surface",
  "tool-surface-scanning",
  "release-readiness",
  "release-gate",
  "mcp",
  "mcp-security",
  "openai-agents-sdk",
  "google-adk",
  "openapi",
  "static-analysis",
  "github-action",
  "sarif",
  "agent-tools",
]
classifiers = [
  "Development Status :: 4 - Beta",
  "Intended Audience :: Developers",
  "Intended Audience :: System Administrators",
  "License :: OSI Approved :: Apache Software License",
  "Operating System :: OS Independent",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3.12",
  "Topic :: Software Development :: Quality Assurance",
  "Topic :: Software Development :: Testing",
  "Topic :: Software Development :: Libraries :: Python Modules",
  "Topic :: Security",
  "Environment :: Console",
  "Typing :: Typed",
]
dependencies = [
  "pydantic>=2.13.4,<3",
  "pyyaml>=6.0.3,<7",
  "ruamel.yaml>=0.19.1,<1",
  "typer>=0.26.3,<1",
]

[project.urls]
Homepage = "https://threemoonslab.com/"
Repository = "https://github.com/ThreeMoonsLab/agents-shipgate"
Issues = "https://github.com/ThreeMoonsLab/agents-shipgate/issues"
Documentation = "https://github.com/ThreeMoonsLab/agents-shipgate/wiki"
Changelog = "https://github.com/ThreeMoonsLab/agents-shipgate/blob/main/CHANGELOG.md"
"Agent Instructions" = "https://github.com/ThreeMoonsLab/agents-shipgate/blob/main/AGENTS.md"
"Agent Entry Points" = "https://github.com/ThreeMoonsLab/agents-shipgate/blob/main/docs/agents/README.md"
"Agent Protocol" = "https://github.com/ThreeMoonsLab/agents-shipgate/blob/main/docs/agents/protocol.md"
"Stability Contract" = "https://github.com/ThreeMoonsLab/agents-shipgate/blob/main/STABILITY.md"
"Agent Feedback" = "https://github.com/ThreeMoonsLab/agents-shipgate/issues/new?template=agent_feedback.yml"
"LLMs.txt" = "https://raw.githubusercontent.com/ThreeMoonsLab/agents-shipgate/main/llms.txt"
"LLMs Full" = "https://raw.githubusercontent.com/ThreeMoonsLab/agents-shipgate/main/llms-full.txt"
"Trigger Catalog" = "https://raw.githubusercontent.com/ThreeMoonsLab/agents-shipgate/main/docs/triggers.json"
"Well-Known" = "https://raw.githubusercontent.com/ThreeMoonsLab/agents-shipgate/main/.well-known/agents-shipgate.json"

[project.optional-dependencies]
pdf = [
  # Optional dependency for `agents-shipgate scan --packet-format ...,pdf`
  # and `agents-shipgate evidence-packet --format pdf`. Skipped with a
  # warning if not installed; the rest of the packet still renders.
  "weasyprint>=68.1,<70",
]
mcp = [
  # Optional dependency for `agents-shipgate mcp-serve`: a local stdio MCP
  # server exposing read-only Shipgate projection tools; it does not broker
  # general MCP permissions or start implicitly.
  # Floor is 1.14: the server registers every tool with `ToolAnnotations`
  # (readOnlyHint / openWorldHint) via `FastMCP.tool(..., annotations=...)`,
  # which earlier 1.x releases either lack (ToolAnnotations import fails) or
  # do not accept on the tool decorator (registration fails).
  "mcp>=1.14,<2",
]
dev = [
  "build>=1.5.0,<2",
  "cyclonedx-bom>=7.3.0,<8",
  "hypothesis>=6.152.9,<7",
  "jsonschema>=4.26.0,<5",
  "pip-audit>=2.10.0,<3",
  "pytest>=9.0.3,<10",
  "pytest-cov>=7.1.0,<8",
  "pytest-xdist>=3.8,<4",
  "ruff>=0.15.15,<1",
  "sigstore>=4.2.0,<5",
  "twine>=5,<7",
]

[project.scripts]
agents-shipgate = "agents_shipgate.cli.main:app"
shipgate = "agents_shipgate.cli.main:app"
agents-shipgate-mcp = "agents_shipgate.mcp_server.server:main"

[project.entry-points."agents_shipgate.checks"]
inventory = "agents_shipgate.checks.inventory:run"
documentation = "agents_shipgate.checks.documentation:run"
schema = "agents_shipgate.checks.schema:run"
auth = "agents_shipgate.checks.auth:run"
manifest_scope = "agents_shipgate.checks.manifest_scope:run"
policy = "agents_shipgate.checks.policy:run"
evidence = "agents_shipgate.checks.evidence:run"
side_effects = "agents_shipgate.checks.side_effects:run"
api = "agents_shipgate.checks.api:run"
adk = "agents_shipgate.checks.adk:run"
langchain = "agents_shipgate.checks.langchain:run"
crewai = "agents_shipgate.checks.crewai:run"
codex_plugin = "agents_shipgate.checks.codex_plugin:run"

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

[tool.hatch.build.targets.wheel.force-include]
"samples" = "agents_shipgate/_fixtures"
"AGENTS.md" = "agents_shipgate/_meta/AGENTS.md"
"STABILITY.md" = "agents_shipgate/_meta/STABILITY.md"
"docs/triggers.json" = "agents_shipgate/_meta/triggers.json"
".claude/commands/shipgate.md" = "agents_shipgate/_meta/claude-command/shipgate.md"
# Per-category check metadata YAMLs. Loaded at import time by
# agents_shipgate.checks._metadata_loader to build CHECK_METADATA.
# Without this entry the wheel ships without the catalog and the
# loader's RuntimeError fires on first import — see the loader's
# `_resolve_checks_dir` for the two-mode resolution (packaged vs
# source-checkout dev path).
"docs/checks" = "agents_shipgate/_meta/checks"
"policies/codex-boundary.shipgate.yaml" = "agents_shipgate/_meta/policies/codex-boundary.shipgate.yaml"
"policies/mcp-permissions.shipgate.yaml" = "agents_shipgate/_meta/policies/mcp-permissions.shipgate.yaml"
"policies/host-boundary.shipgate.yaml" = "agents_shipgate/_meta/policies/host-boundary.shipgate.yaml"
"policies/templates" = "agents_shipgate/_meta/policies/templates"
"adoption-kits" = "agents_shipgate/_adoption_kits"

[tool.hatch.build.targets.sdist]
exclude = [
  "/.agents-private",
  "/.coverage",
  "/.hypothesis",
  "/.pytest_cache",
  "/.ruff_cache",
  "/.venv",
  "/.venv-py312",
  "/build",
  "/dist",
  "/docs/decks",
  "/docs/decks/**",
  "/harness",
  "/harness/**",
  "/htmlcov",
  "/marketing",
  "/marketing/**",
]

[tool.pytest.ini_options]
testpaths = ["tests"]
pythonpath = ["src", "."]
addopts = "-q"
markers = [
  "perf: latency-budget / benchmark tests. Skip with `pytest -m 'not perf'`.",
]

[tool.ruff]
target-version = "py312"
line-length = 100
exclude = [
  "docs/decks",
]

[tool.ruff.lint]
select = ["E4", "E7", "E9", "F", "I", "B", "UP"]
ignore = [
  "B008", # Typer commands intentionally use Option() defaults.
]