🗺️ Mapeamento do Workspace

O PAEBIRU é um workspace Cargo extenso com mais de 30 membros. Este guia ajuda você a se localizar e entender a maturidade de cada componente.

1. Estrutura de Diretórios

paebiru/
├── apps/               # Aplicações finais (binários)
├── crates/             # Bounded Contexts e bibliotecas core
│   ├── bindings/       # Bindings para 13 linguagens (FFI)
├── docs/               # Documentação mdBook (esta que você lê)
├── simulations/        # Simulações hardware-in-the-loop (Python)
└── supply-chain/       # Auditorias e travas de dependências

2. Maturidade por Crate (Fase 1)

Crate	Bounded Context	Estado	Responsabilidade
`paebiru-kernel`	Kernel	🟢 Estável	Loop GALS, Rede, Segurança
`paebiru-node`	(App)	🟢 Estável	Daemon principal do nó
`paebiru-math`	Matemática	🟡 Beta	Ising, Langevin, Reed-Solomon
`paebiru-biology`	Biologia	🟠 Alfa	ABAPORU, SNN
`paebiru-economy`	Economia	🟠 Alfa	DRE, Barter, Joule
`paebiru-capiba`	C.A.P.I.B.A.	🟠 Alfa	Persistência Causal
`paebiru-hal`	HAL	🟠 Alfa	no_std, Drivers
`paebiru-api`	API	🟠 Alfa	HTTP, Metrics, Tracing

3. Fluxo de Dependências

Para preservar o Dogma 1 (Isolamento Hexagonal), seguimos uma hierarquia estrita:

paebiru-math e paebiru-commons são a base (zero dependências internas).
paebiru-kernel depende da base.
Bounded Contexts de domínio (biology, economy, learn) dependem do kernel através de traits.
paebiru-node orquestra tudo, injetando as implementações concretas.

4. Bindings de Linguagem

Os crates em crates/bindings/ são pontes FFI. Eles não devem conter lógica de domínio, apenas mapeamentos de tipos e chamadas para o core em Rust.

5. Veja também

Roadmap — Visão temporal da maturidade.
Qualidade · Dogma 1
AGENTS.md — Lista técnica completa de crates.