Metadata-Version: 2.4
Name: abi-prd
Version: 0.1.4
Summary: Deterministic, budget-aware AI orchestration kernel for PRD generation
Project-URL: Homepage, https://github.com/AbilityBI/abi-prd
Project-URL: Repository, https://github.com/AbilityBI/abi-prd
Project-URL: Documentation, https://abilitybi.github.io/abi-infra/
Project-URL: Changelog, https://github.com/AbilityBI/abi-prd/blob/main/CHANGELOG.md
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: abi-control-core<0.2.0,>=0.1.0
Requires-Dist: jsonschema<5,>=4.23
Requires-Dist: pydantic<3.0,>=2.10.0
Requires-Dist: rich<14.0,>=13.0
Requires-Dist: typer<1.0,>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pre-commit>=3.7; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == 'mcp'
Description-Content-Type: text/markdown

# abi-prd

Deterministic, budget-aware PRD generation engine. Runs a dialectical workflow (thesis → antithesis → synthesis) to produce structured, schema-validated Product Requirements Documents. Part of the **Planning Pack (Layer 2)**.

Depends on `abi-control-core` for schema validation and audit trail artifacts.

## Install

```bash
pip install abi-prd
```

## Quick start (CLI)

```bash
# Generate a PRD from an idea (simulation mode — no real LLM calls)
dialectic run --idea "Add OAuth2 authentication to the API" --simulation

# Full run with a config file
dialectic run --idea "User dashboard" --config config.json --output-dir runs/

# Deterministic smoke test
dialectic run --idea "Test feature" --smoke
```

## Quick start (Python)

```python
from dpe.engine.orchestrator import Orchestrator
from dpe.engine.config_loader import load_config

# Load configuration (supports simulation mode)
config = load_config(None, simulation_mode=True, output_dir="runs/")

# Run the dialectical PRD generation workflow
orchestrator = Orchestrator(config)
result = orchestrator.run(idea="Add user authentication")
```

## What's included

- **Dialectical workflow** -- thesis/antithesis/synthesis cycle for structured PRD generation
- **Budget enforcement** -- token, time, and cost budgets with deterministic tracking
- **Multi-provider adapters** -- Anthropic, OpenAI, Claude Code CLI, Codex CLI, local, and simulation
- **Schema validation** -- generated PRDs are validated against `abi-control-core` contracts
- **Audit trail artifacts** -- each generation run produces sealed audit trail artifacts
- **CLI** -- `dialectic` command for quick PRD generation

## ABI ecosystem

`abi-prd` is part of the Planning Pack (Layer 2), built on top of `abi-control-core` (Layer 1). It pairs with `abi-spec` to form the full planning pipeline: PRD generation followed by specification compilation.

Related packages:

- [abi-control-core](https://github.com/AbilityBI/abi-core) -- contracts and audit trail SDK (Layer 1, required)
- [abi-spec](https://github.com/AbilityBI/abi-spec) -- specification compiler (Layer 2)
- [abi-evals](https://github.com/AbilityBI/abi-evals) -- eval runner for validating PRD quality

## Versioning

Follows Semantic Versioning. Current version: `0.1.4`. See CHANGELOG.md for release notes.

## License

MIT License (see LICENSE file).
