Metadata-Version: 2.4
Name: autoclaw
Version: 0.1.1
Summary: AutoClaw local-first workflow control plane
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: fastapi<1.0.0,>=0.115.12
Requires-Dist: uvicorn[standard]<1.0.0,>=0.34.0
Requires-Dist: sqlalchemy<3.0.0,>=2.0.40
Requires-Dist: pydantic<3.0.0,>=2.11.3
Requires-Dist: pydantic-settings<3.0.0,>=2.8.1
Requires-Dist: mcp<2.0.0,>=1.27.1
Requires-Dist: python-dotenv<2.0.0,>=1.1.0
Requires-Dist: httpx<1.0.0,>=0.28.1
Requires-Dist: platformdirs<5.0.0,>=4.3.7
Requires-Dist: aiosqlite<1.0.0,>=0.21.0
Provides-Extra: postgres
Requires-Dist: asyncpg<1.0.0,>=0.30.0; extra == "postgres"
Provides-Extra: dev
Requires-Dist: pytest<9.0.0,>=8.3.5; extra == "dev"
Requires-Dist: pytest-asyncio<1.0.0,>=0.26.0; extra == "dev"
Requires-Dist: pytest-cov<7.0.0,>=6.1.1; extra == "dev"
Requires-Dist: ruff<1.0.0,>=0.11.5; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
Requires-Dist: PyYAML<7.0.0,>=6.0.2; extra == "dev"
Requires-Dist: types-PyYAML<7.0.0,>=6.0.12.20250326; extra == "dev"
Requires-Dist: asyncpg<1.0.0,>=0.30.0; extra == "dev"

# AutoClaw

Last verified: 2026-05-07

AutoClaw is a controlled agent runtime for multi-step work that must stay auditable, replayable, and operationally recoverable.

This root README is a front-door router only. Canonical implementation, redesign, and execution truth lives under `docs/`.

## Start here

- Current shipped behavior: [docs/current/README.md](docs/current/README.md)
- Target redesign contract: [docs/redesign/README.md](docs/redesign/README.md)
- Redesign landing and phase execution: [docs/execution/README.md](docs/execution/README.md)
- Docs map and reading guide: [docs/README.md](docs/README.md)
- Coding-agent policy: [AGENTS.md](AGENTS.md)
- Coding standards: [STYLE.md](STYLE.md)

## Repo shape

- `apps/api/` - backend API, runtime, DB, CLI, and tests
- `definitions/` - workflow and definition content used by owning phases
- `docs/` - current behavior, redesign contract, and execution canon
- `scripts/` - repo tooling, including docs validation under `scripts/docs/`
- `examples/` - example workflows and supporting artifacts

## Common verification lanes

- Local backend suite: `./.venv/bin/pytest -q apps/api/tests`
- Docker/Postgres verification: `make test-api-db`
- Docs freeze validation: `./.venv/bin/python scripts/docs/docs_freeze_validate.py`

## Surface rule

Use this page for fast routing only.

Do not treat it as the authoritative source for detailed runtime behavior, redesign contracts, or phase-closeout status.
