CLI — `paebiru-cli` (Forge)

Interface de controle, monitoramento e flash embarcado para nós PAEBIRU.

Detalhe granular em crates/cli/README.md (CLI externa) e src/cli/README.md (Forge CLI interna).

Duas faces do Forge

	`paebiru-cli` (externa)	`Forge CLI` (interna ao nó)
Quando	Operador humano	Auto-teste do nó
Como	Binário em `crates/cli`	Módulo em `src/cli/`
Para que	`status`, `metabolism`, `view`, `flash`, `mutate`	Caos algedônico, lakehouse, validação de invariantes

CLI externa (`paebiru-cli`)

`status`

Snapshot da saúde do organismo: health, peer count, localização base.

$ paebiru-cli status
--- PAEBIRU NODE STATUS ---
Health:   optimal
Peers:    10
Location: Rizoma

Origem: GET /status (API.md).

`metabolism`

Saldo econômico (Joules) e nível de dor sistêmica.

$ paebiru-cli metabolism
--- METABOLISM METRICS ---
Balance:    7777 Joules
Pain Level: 42.00%

Origem: GET /metabolism. 1 Joule ≈ 100.000 unidades de fuel WASM (conversão determinística — ECONOMY.md).

`view`

TUI interativa (ratatui). Atualiza a cada 500 ms. q para sair. Mostra metabolismo, peers e sinais vitais em painéis simultâneos.

`flash`

Compila e grava o firmware paebiru-hal em hardware físico.

paebiru-cli flash --target <TARGET> --node-id <NODE_ID> [--port <PORT>] [--firmware <PATH>]

Alvo	Toolchain	Requisito local
`esp32-c3`	`cargo-espflash`	`--port /dev/ttyUSB0`
`stm32wl55`	`probe-rs`	Debug probe
`rpi-zero2w`	SSH + `rsync`	SSH key + host alcançável

`forge mutate`

Compila e propaga definições de hardware (VHDL/Verilog/WASM-to-Hardware) pela malha rizomática.

$ paebiru-cli forge mutate --bitstream <PATH> --broadcast
--- HARDWARE MUTATION TRIGGERED ---
Synthesizing bitstream: [OK]
Calculating Activation Barrier (Simulated Annealing): [0.82]
Mutation Approved: Flashing FPGA...
Spreading Bitstream Pheromone...

Detalhes do runtime embedded em engineering/EMBEDDED.md.

Variáveis de ambiente

Var	Default	Uso
`PAEBIRU_API_URL`	`http://localhost:1975`	Endpoint do nó-alvo
`OUROBOROS_OVERRIDE`	`0`	Ativa monitoramento de Bekenstein e colapso recursivo

Forge CLI interna (`src/cli/`)

Diferente do binário externo, este módulo está acoplado ao InternalEventBus para auto-teste e endurecimento sociotécnico.

Limiares algedônicos canônicos

Nível	Faixa	Disparador
Normal	`pain < 0.2`	Batimento padrão
Aviso	`0.2 ≤ pain < 0.5`	Monitoramento defensivo
Crítico	`0.5 ≤ pain < 0.8`	`ResourceOsmosis` (`MycorrhizalSymbiosis`)
Morte Térmica	`pain ≥ 0.8`	`CryptobiosisTriggered` (esporulação)
Ouroboros	`limit ≥ 0.999`	`trigger_collapse()` (Colapso Recursivo - RFC 039)

Nota: a esporulação automática em pain > 0.95 é decidida pelo MetaHomeostasis (BIOLOGY.md); o Forge usa 0.8 como gatilho de teste mais conservador para acionar caos controlado sem destruir o nó. O nível Ouroboros é irreversível.

Disparando caos

#![allow(unused)]
fn main() {
PaebiruForgeCLI::simulate_chaos(0.75).await;
PaebiruForgeCLI::simulate_big_bang().await; // Easter Egg: Imprime mensagem de colapso
}

Injeta um evento de dor algedônica diretamente no AlgedonicSensor e valida transições de homeostase ao longo das fronteiras acima.

Provisionamento de Lakehouse C.A.P.I.B.A.

Inicializa o continuum local (Nascente → Correnteza → Manguezal → Oceano — ver CAPIBA.md) para que o nó esteja pronto para Compute-over-Data e treinamento FL.

Cross-references

API.md — endpoints consumidos por status e metabolism.
BIOLOGY.md — AlgedonicSensor e MetaHomeostasis.
engineering/EMBEDDED.md — runtime e drivers de flash.
crates/cli/README.md, src/cli/README.md — referências locais granulares.

Keyboard shortcuts