# Contribuindo

## Testes

`composer install` e depois `composer test` (PHPUnit, `tests/`) — ou `composer lint` para checar
só a sintaxe (`php -l`) de todos os arquivos. Roda automaticamente no `bitbucket-pipelines.yml` a
cada push neste repositório. Funções puras (sem rede) têm prioridade de cobertura — ver
`tests/bootstrap.php` para como o ambiente de teste é isolado (SQLite/log temporários, sem
`OPENAI_API_KEY` nem webhooks reais).

## Commits (Conventional Commits)

Adote [Conventional Commits](https://www.conventionalcommits.org/): `feat:`, `fix:`, `docs:`, `chore:`, `refactor:`, `test:`.

Para mudanças incompatíveis, use `BREAKING CHANGE:` no corpo ou `feat!:` no título.

## Pull requests

Mantenha PRs focados; descreva impacto e como testar.

## Changelog

Atualize `CHANGELOG.md` (`[Unreleased]`) quando a alteração for relevante para quem usa ou opera o projeto.