PAEBIRU

Protocolo Assíncrono de Ecossistemas Biológicos para Infraestruturas Recursivas Universais

Especificações técnicas, arquiteturais e de processo do protocolo PAEBIRU.

Top-level (canônico)

• SETUP.md — preparação do ambiente, toolchain, primeiro build.
• ROADMAP.md — plano de execução em 17 fases, com status por fase.
• theory/introduction.md — visão arquitetônica completa, mapeamento doc↔código (theory/workspace_mapping.md), corte v1/v2+/pesquisa (theory/workspace_mapping.md), questões em aberto (theory/workspace_mapping.md).

Subdiretórios

• architecture/ — Bounded Contexts

  • Detalhamento por subsistema: Kernel, Biologia, Economia, C.A.P.I.B.A., Aprendizado, Entropia, API, Bridges, e o ensaio transversal The Reality Is Fractal.

• theory/ — Teoria e Fundamentos

  • introduction.md — visão arquitetônica canônica.

• rfc/ — Especificações Normativas

• reference/ — Material de Referência

  • DICTIONARY.md — glossário canônico.
  • PATTERNS.md — padrões arquitetônicos (Actor-like State, Trait-Provider, Opaque Handle, etc.).
  • MATHEMATICS.md — stack matemática (Ising, Langevin, Reed-Solomon, TDA).
  • DSL.md — DSL de plasmídeos: sintaxe TOML, capabilities, handlers.
  • SDK.md — referência do paebiru-sdk: Context, SovereignReceipt, PaebiruClient, x402 auto-negotiation.
  • CLI.md — referência do Forge CLI (status, metabolism, view, flash).

• engineering/ — Como Trabalhamos

  • PROCESS.md — fluxo de implementação, branches, revisão.
  • QUALITY.md — padrões de qualidade, gates de CI.
  • FORMAL_VERIFICATION.md — invariantes TLA+ / Lean 4.
  • POSTMORTEMS.md — incidentes e lições.
  • EMBEDDED.md — runtime no_std, HAL multiarq, harvesting energético.

• sdk/ — Para Consumidores de SDK

  • ASYNC_DESIGN_RATIONALE.md — modelo async dos bindings.
  • PYTHON_ASYNC_PATTERNS.md — integração asyncio em Python.
  • SDK_RELEASE_GUIDE.md — distribuição multi-linguagem.

• bindings/ — Bindings de Linguagem

  • Visão consolidada dos 12 bindings (C, C#, Dart, Go, Java, Lua, PHP, Python, R, Ruby, Swift, TypeScript). Para detalhes de implementação local, ver crates/bindings/<lang>/README.md.

Convenções

• Documentos canônicos refletem o estado-alvo. Discrepâncias com o código vivem como Open Questions em rfc/README.md até serem ratificadas.
• Cada RFC tem um número estável; renomeações são proibidas.
• Cross-references usam caminhos relativos (./engineering/PROCESS.md), nunca absolutos.
• READMEs em src/<módulo>/ e crates/<crate>/ continuam sendo a documentação local ao código. docs/ é a visão transversal integrada.