Metadata-Version: 2.4
Name: a3
Version: 0.2.2
Summary: Foundational scaffolding for the A4 AI workflow orchestrator
Author: A4 Team
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.5
Requires-Dist: pyyaml>=6.0
Requires-Dist: typer>=0.9
Requires-Dist: rich>=13.7
Requires-Dist: fastapi>=0.111
Requires-Dist: uvicorn>=0.30
Requires-Dist: argon2-cffi>=23.1
Requires-Dist: redis>=5.0
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: pytest-cov>=4.1; extra == "dev"
Requires-Dist: mypy>=1.8; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"

# A4

Foundational scaffolding for the A4 AI workflow orchestrator. This repository hosts the CLI and SDK skeleton along with shared infrastructure (configuration, dependency injection, logging) that other phases will extend.

## Getting Started

1. Create a virtual environment with Python 3.10+.
2. Install the package in editable mode:
   ```bash
   pip install -e .[dev]
   ```
3. Run diagnostics:
   ```bash
   a4 --health
   a4 --version
   ```

## Highlights

- **Provider Fallbacks**: Configure multiple AI providers with automatic failover in `a4.yaml` (`ai.fallback_providers`).
- **Resumable Drafting**: Retry interrupted drafting runs with `a4 draft generate --resume`; progress is checkpointed under `.a4/state/`.
- **Usage Analytics**: Telemetry-aware logging writes to `.a4/metrics/`. Inspect summaries with `a4 observe usage` or disable tracking via `features.telemetry=false`.

## Project Structure

- `a4/` - Python package with CLI, configuration loader, and core utilities.
- `.a4/` - Workspace artifacts generated at runtime (plans, specs, drafts, validation).
- `docs/` - Architectural, product, and delivery documentation.
- `tests/` - Automated tests covering core scaffolding.

See `docs/` for detailed design and roadmap information.

## Documentation

- docs/CLI_HANDBOOK.md - CLI usage guide with full command reference.
- docs/SDK_QUICKSTART.md - Programmatic examples for integrating the SDK.
- docs/ACCEPTANCE_REPORT.md - Pilot testing summary and sign-off details.
- docs/POST_LAUNCH_SUPPORT.md - Support rotation and telemetry hand-off plan.
- docs/SYSTEM_ARCHITECTURE.md - Architecture blueprint with release and operations view.

