🛠️ Forge CLI

A Forge CLI (paebiru-cli) é a canivete suíço do ecossistema PAEBIRU. Ela permite gerenciar identidades, monitorar nós em tempo real e realizar o flash de firmware em dispositivos embarcados.

📋 Visão Geral

A CLI foi projetada para ser tanto uma ferramenta de script quanto uma interface visual rica (TUI) para operadores de campo.

Comandos Planejados

Comando	Descrição
`paebiru node status`	Exibe o estado de saúde, peers conectados e backpressure.
`paebiru identity gen`	Gera uma nova identidade soberana (enraizada em hardware se disponível).
`paebiru identity export`	Exporta a chave pública/PeerID para a malha.
`paebiru flash`	Ferramenta de flashing para ESP32, STM32 e RISC-V.
`paebiru dashboard`	Inicia a TUI (Interface de Terminal) para monitoramento.

🖥️ Interface de Terminal (TUI)

A Forge CLI incluirá uma interface baseada em ratatui que permite visualizar:

Metabolismo do nó: Gráficos de CPU, memória e tokens de backpressure.
Vizinhança Causal: Mapa de peers e latência causal.
Landauer Ledger: Débitos e créditos energéticos em tempo real.

🔌 Flashing de Embarcados

Uma das funções críticas da Forge CLI é a preparação de MuleNodes. Através do comando flash, a ferramenta:

Detecta o hardware conectado (via USB/Serial).
Compila (se necessário) o firmware paebiru-hal para o alvo.
Grava o firmware e configura a identidade inicial no dispositivo.

⏭️ Próximos passos

Após entender as ferramentas de gestão, você está pronto para escrever seu Primeiro plasmídeo.