Metadata-Version: 2.4
Name: audiagentic
Version: 0.2.1
Summary: AUDiaGentic: Agentic workflow orchestration and execution platform
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: babel>=2.15
Requires-Dist: dulwich<0.26,>=0.24
Requires-Dist: pyyaml>=6.0
Requires-Dist: rapidfuzz>=3.0
Requires-Dist: jsonschema>=4.18
Requires-Dist: mcp==1.27.0
Requires-Dist: pydantic<3,>=2.11
Requires-Dist: tomli-w>=1.0
Requires-Dist: rich>=15.0.0
Provides-Extra: acp
Requires-Dist: agent-client-protocol==0.11.0; extra == "acp"
Provides-Extra: a2a
Requires-Dist: a2a-sdk==1.1.2; extra == "a2a"
Provides-Extra: mcp
Requires-Dist: mcp==1.27.0; extra == "mcp"
Requires-Dist: tomli-w>=1.0; extra == "mcp"
Provides-Extra: gpt-auto
Requires-Dist: websockets>=13.0; extra == "gpt-auto"
Provides-Extra: test
Requires-Dist: pytest>=9.0; extra == "test"
Requires-Dist: pytest-asyncio>=1.3; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Requires-Dist: pytest-timeout>=2.3; extra == "test"
Requires-Dist: pytest-xdist>=3.0; extra == "test"
Requires-Dist: psutil>=5.9; extra == "test"
Requires-Dist: mcp==1.27.0; extra == "test"
Requires-Dist: tomli-w>=1.0; extra == "test"
Requires-Dist: pyright>=1.1; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest>=9.0; extra == "dev"
Requires-Dist: pytest-asyncio>=1.3; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.3; extra == "dev"
Requires-Dist: pytest-xdist>=3.0; extra == "dev"
Requires-Dist: psutil>=5.9; extra == "dev"
Requires-Dist: mcp==1.27.0; extra == "dev"
Requires-Dist: tomli-w>=1.0; extra == "dev"
Requires-Dist: pyright>=1.1; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: mypy; extra == "dev"

# AUDiaGentic

Multi-agent workflow orchestration system for AI coding agents. Provides the infrastructure to plan, execute, and track software engineering work across coordinated agent sessions.

## Quick links

- **[docs/layout.md](docs/layout.md)** — directory layout and config hierarchy
- **[docs/planning/](docs/planning/)** — planning system (requests, specs, tasks, plans, work packages)
- **[docs/releases/](docs/releases/)** — current release and audit docs
- **[docs/testing/](docs/testing/)** — test environment and architecture
- **[docs/knowledge/](docs/knowledge/)** — knowledge vault
- **[docs/examples/](docs/examples/)** — example project scaffold
- **[docs/archive/](docs/archive/)** — superseded references

## Source code

| Layer | Path | Contents |
|-------|------|----------|
| Foundation | `src/audiagentic/foundation/` | Contracts, config, events, workflow primitives |
| Runtime | `src/audiagentic/runtime/` | Lifecycle management, state |
| Components | `src/audiagentic/components/optional/` | Providers, coding LSP, ledger, agent jobs, release, source control |

## Installation

For a released build, install the package from PyPI:

```bash
python3 -m venv ~/.venvs/audiagentic
source ~/.venvs/audiagentic/bin/activate
python -m pip install --upgrade audiagentic
```

The GitHub Release workflow builds and attaches the wheel and source archive
to each release and publishes them to PyPI using GitHub Trusted Publishing.
See
[`docs/releases/PYPI_PUBLISHING.md`](docs/releases/PYPI_PUBLISHING.md).

## Docker test path

Use the existing Docker base image as the normal test path. Do not rebuild test images for routine validation unless the image inputs changed.

Normal path:

```bash
docker run --rm \
  -v "${PWD}:/app" \
  -w /app \
  -e AUDIAGENTIC_DOCKER_TESTS=1 \
  -e AUDIAGENTIC_REPO_ROOT=/app \
  audia-test-base:latest \
  bash -lc "python3 -m pip install --no-cache-dir --break-system-packages -e . pytest pytest-asyncio mcp==1.27.0 && pytest tests/integration/release tests/e2e/release -q"
```

Rebuild only when one of these changed:

- `tests/docker/Dockerfile.test-base`
- `tests/docker/Dockerfile.test`
- `tests/docker/Dockerfile.release-test`
- image-level package/tool bootstrap requirements
- the local image is missing or known-bad

Use `tests/docker/Dockerfile.release-test` only when validating the wheel-installed release path or package-data bundling. It is not the default recheck path.

## Testing

- **[docs/testing/TEST_ENVIRONMENT.md](docs/testing/TEST_ENVIRONMENT.md)** — primary test environment guide
- **[docs/testing/TEST_ARCHITECTURE.md](docs/testing/TEST_ARCHITECTURE.md)** — test architecture overview
