Metadata-Version: 2.4
Name: agentsflow
Version: 0.0.1
Summary: Add your description here
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: agent-client-protocol>=0.6.2
Requires-Dist: fastmcp>=2.13.0.2
Requires-Dist: gitpython>=3.1.43
Requires-Dist: jira>=3.8.0
Requires-Dist: logfire>=4.14.2
Requires-Dist: pydantic-ai-slim[openai,temporal]>=1.9.1
Requires-Dist: pydantic-settings>=2.4.0
Requires-Dist: pygithub>=2.5.0
Requires-Dist: temporalio>=1.18.0
Provides-Extra: dev
Requires-Dist: mike>=2.1.1; extra == 'dev'
Requires-Dist: mkdocs-autorefs>=1.0.1; extra == 'dev'
Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
Requires-Dist: mkdocs>=1.6.0; extra == 'dev'
Requires-Dist: mkdocstrings[python]>=0.24.3; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
Requires-Dist: pymdown-extensions>=10.11.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

AgentsFlow
==========

[![Docs](https://img.shields.io/badge/docs-latest-0a7ea4?logo=readthedocs&logoColor=white)](https://docs.agentsflow.dev)

Temporal workflows and activities for the AgentsFlow SDLC automation stack. This README is intentionally thin—full operator and contributor docs live at [docs.agentsflow.dev](https://docs.agentsflow.dev). New operators can jump straight to the Quickstart/Deployment guides on the docs site.

Quick start (local stack)
-------------------------
```bash
python -m agentsflow.dev
```
This launches Temporal dev (if port 7233 is free), the AgentsFlow worker, and the MCP server with `stdio` transport. Set your `.env` first (`OPENAI_API_KEY`, Jira or GitHub creds) and pass `--transport http|sse|streamable-http` if you prefer a different MCP transport. Keep the process running while you trigger workflows via the CLI or MCP.

Architecture (high level)
-------------------------
```mermaid
flowchart LR
  Dev[CLI / MCP client] -->|start SDLC workflow| Temporal[Temporal Server]
  Temporal --> Worker[AgentsFlow worker]
  Worker --> Activities[Git / Issue / ACP activities]
  Activities --> Repo[(Git worktree)]
  Activities --> Providers[Jira or GitHub issues]
  Activities --> ACP[Claude / Gemini / Codex ACP]
```

Supported issue providers
-------------------------
| Provider | Credentials | Notes |
| --- | --- | --- |
| Jira | `JIRA_EMAIL` + `JIRA_API_TOKEN` (optional `JIRA_HOST_ALLOWLIST`, `JIRA_TIMEOUT_SECONDS`) | Hosts matching `atlassian.net`/`jira` or allowlisted domains route here. |
| GitHub | `GITHUB_TOKEN` (optional `GITHUB_TIMEOUT_SECONDS`) | Uses the GitHub Issues API for `github.com/<org>/<repo>/issues/<id>` URLs. |

Docs
----
- New operators: Quickstart + deployment: https://docs.agentsflow.dev
- SDLC workflow: https://docs.agentsflow.dev/workflows/sdlc
- Providers + env reference: https://docs.agentsflow.dev/guides/providers
