# Contributing to aria-agentkit

Thank you for your interest in contributing.

## Getting Started

```bash
git clone https://github.com/EmpowerID/aria-agentkit.git
cd aria-agentkit
pip install -e ".[dev]"
```

## Running Tests

```bash
pytest tests/ -v
```

Contract tests (require `agent-os-kernel`):

```bash
pytest tests/contract/ -v -m contract
```

## Code Quality

All code must pass before merge:

```bash
ruff check src/ tests/
ruff format --check src/ tests/
mypy src/
```

## Pull Request Guidelines

1. Branch from `main`.
2. One logical change per PR.
3. Include tests for new behavior.
4. Update `CHANGELOG.md` under an `[Unreleased]` section.
5. Ensure all CI checks pass.

## Commit Messages

Use conventional commit style:

- `feat: add support for X`
- `fix: handle edge case in Y`
- `test: add golden tests for mapping`
- `docs: update version matrix`

## Scope

This package is a narrow bridge between AGT extension points and ARIA services. Contributions should stay within this scope:

- Policy adapters for AGT interfaces
- Audit export to ARIA Receipt Vault
- MCP configuration helpers for ARIA MCP Gateway

Features outside this scope (LLM proxy, budget management, approval workflows) belong in separate packages.
