🌿 Apresentação

Você chegou ao PAEBIRU — Protocolo Assíncrono de Ecossistemas Biológicos para Infraestruturas Recursivas Universais. Esta documentação é a fonte canônica de verdade. Está organizada em três trilhas — escolha a que combina com o seu momento.

flowchart LR
    A[Quem é você?] --> B{Primeira vez?}
    B -- Sim --> C[🌱 Estou chegando<br/>README · MANIFESTO<br/>ROADMAP · SETUP]
    B -- Não --> D{Operando em campo?}
    D -- Sim --> E[🔧 Vou operar<br/>Runbooks · Flashing<br/>Observabilidade]
    D -- Não --> F[🛠️ Vou contribuir<br/>RSE · 4 Dogmas<br/>RFCs · Bounded Contexts]

🌱 Estou chegando

Você nunca trabalhou com o PAEBIRU antes — perfeito. Comece por aqui.

Passo	O que ler	O que fazer
1	Manifesto	Entenda a visão: por que outra plataforma P2P?
2	Roadmap	Saiba em que fase estamos (Fase 1 — Fundação da Névoa)
3	Setup inicial	Instale o toolchain (Nix recomendado)
4	Primeiros passos	Suba um nó, escreva um plasmídeo, converse com a malha

Glossário essencial — malha, GALS, Maturidade Causal, Algedonic, LandauerLedger, Estigmergia — definidos no Dicionário canônico. Volte a ele sempre que um termo parecer novo.

🔧 Vou operar

Você é operador de campo: o nó está implantado, o termostato está a 65 °C no armário de telecom e o pager tocou às 3h. Esta trilha é o seu manual.

Necessidade	Vá direto para
O nó não sobe	R001 · Boot de nó em campo
Identidade / TPM	R002 · Identidade TPM
Rotação de chaves	R003 · Rotação FROST
Ledger corrompido	R004 · Recuperação de ledger
Pacote suspeito	R005 · Quarentena MacrophageVM
Atualização OTA	R006 · Atualização OTA
Tráfego DDoS	R007 · Saturação XDP
Drift de relógio	R008 · Langevin clock drift
Migrar para Oceano	R009 · Migração para Oceano
ZK-PoL falhou	R010 · Falha de ZK-PoL
Desastre total	R011 · Disaster recovery

Para o ciclo completo, comece pelo Caderno do operador.

🛠️ Vou contribuir

Você é engenheiro(a) — quer modificar o código, abrir uma RFC, ou entender a arquitetura. Esta trilha é o seu guia.

Etapa	Documento
Processo	RSE (Research → Strategy → Execution)
Contrato	4 Dogmas Inquebráveis
Testes	Verificação formal TLA+/Lean 4
Onde mexer	Mapeamento workspace × fase
Especificar	Escrevendo RFCs
Documentar	Escrevendo docs
i18n	Internacionalização

Para entender a forma do organismo:

Para entender o porquê teórico:

🗺️ Onde encontrar o quê

Pergunta	Resposta
O que é o PAEBIRU?	Manifesto
Em que pé está?	Roadmap
Como instalo?	Setup
O que significa X?	Dicionário
Como funciona Y?	Bounded Context de Y
Como operei?	Runbooks
Como contribuir?	Guia de contribuição
Como reporto segurança?	Política de segurança

📐 Convenções editoriais

Esta documentação segue convenções estritas (§9 do AGENTS.md):

kebab-case em nomes de arquivo (exceção: rfcNNN_*.md).
Metadados em comentários HTML (), nunca em frontmatter YAML — o mdBook renderiza YAML como texto visível.
Caminhos relativos em todos os links. Caminhos absolutos são proibidos (a CI quebra o build).
Diagramas em Mermaid (code-first), não imagens binárias.
Português brasileiro (pt-BR) como idioma principal; termos técnicos canônicos são obrigatórios.

🌐 Onde nos encontrar

Homepage: https://paebiru.org
Repositório canônico: https://github.com/paebiru/paebiru
Issues & RFCs: https://github.com/paebiru/paebiru/issues
Segurança (vulnerabilidades): ver SECURITY.md ou e-mail direto (canal privado, sem abrir issue pública)

Keyboard shortcuts