This release is a pre-release and may not be stable for production use.
ESAA — Event Sourcing for Autonomous Agents
ESAA é um protocolo de governança para engenharia de software com agentes. O agente propõe intenções; o Orchestrator valida e aplica efeitos; o histórico append-only permite reconstruir o estado e auditar cada transição.
Agent proposes -> Orchestrator validates -> Event store records -> Projection updates
Este repositório contém o runtime Python esaa-core, contratos, templates e testes.
O ESAA não usa MCP. .roadmap/activity.jsonl é a fonte da verdade; as projeções
não são editadas manualmente.
Quickstart
python -m pip install --upgrade --pre esaa-core
python -m esaa --version
mkdir esaa-demo
cd esaa-demo
python -m esaa bootstrap --profile public
python -m esaa --runner codex init
python -m esaa verify
python -m esaa eligible
Use o runner real no lugar de codex. Um workspace novo começa sem tarefas;
eligible vazio é normal. verify_status: ok confirma consistência com replay.
Consulte python -m esaa task create --help para criar uma tarefa.
bootstrap instala contratos e guias portáteis. Não altera histórico ou projeções.
Em projetos existentes, escolha explicitamente preservar ou mesclar guias;
--force sobrescreve os arquivos permitidos. Detalhes na referência CLI.
Nenhum desses comandos autoriza publicação. O pacote permanece em beta.
Documentação sob demanda
| Necessidade | Referência |
|---|---|
| Começar e configurar o projeto | Primeiros passos · English |
| Entender o modelo e quando usar | Por que ESAA · English |
| Trabalhar com Codex ou Claude Code | Runners · English |
| Operações, arquitetura e recuperação | Referência CLI · English |
| Exemplos de uso | Cenários · English |
| Plugins | Autoria · Instalação · Ciclo · Segurança |
| Modelo de ameaças | Português · English |
| Contribuir com o Core | AGENTS.md · CONTRIBUTING.md |
Os guias do repositório explicam o Core; os guias empacotados atendem projetos consumidores e não precisam ser cópias deste README. Os perfis PARCER são referências por papel, sem leitura obrigatória de todos os perfis.
Desenvolvimento
No checkout, use a fonte local para evitar importar uma instalação antiga:
PYTHONPATH=src python -B -m esaa --help
PYTHONPATH=src python -B -m pytest -q
PYTHONPATH=src python -B -m esaa --root . verify
Mudanças de comportamento exigem evidência proporcional; veja CONTRIBUTING. Não há aprovação de release implícita no sucesso dos testes locais.
Referência acadêmica e licença
@article{santos2026esaa,
title={ESAA: Event Sourcing for Autonomous Agents in LLM-Based Software Engineering},
author={Santos Filho, Elzo Brito dos},
year={2026},
note={Preprint}
}
MIT. Autor: Elzo Brito dos Santos Filho.
1 maintainer
Metadata
1 maintainer
Release files for esaa-core 0.5.0b20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| esaa_core-0.5.0b20.tar.gz | 361.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| esaa_core-0.5.0b20-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 518.2 kB
Release files / esaa_core-0.5.0b20.tar.gz
| Download URL | esaa_core-0.5.0b20.tar.gz |
|---|---|
| Size | 361.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bacdff15ebae709ced316b45ffb89727865304e04bf67ca02746ac7deda385a9
|
|
BLAKE2b-256 checksum How to use checksums |
55120dc3d58e2b521b89348d76b4f3466670b2c0e352ce6f9b1f788b2b274168
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / esaa_core-0.5.0b20-py3-none-any.whl
| Download URL | esaa_core-0.5.0b20-py3-none-any.whl |
|---|---|
| Size | 156.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0340801860f0e6c926d2001c923cbe2b953fdf3ca032d92b7774c9b44d6d9630
|
|
BLAKE2b-256 checksum How to use checksums |
eb0c15e78fe068ba21c8d745fc50c1558d925903af6b96f31818cf834acd2845
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for esaa-core 0.5.0b20
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
