+ Tesseras
+ CLI Encontra a Rede: Comandos Publish, Fetch e Status
+2026-02-15
+Até agora o CLI operava isoladamente: criar uma tessera, verificar, exportar,
+listar o que você tem. Tudo ficava na sua máquina. Com esta atualização, o tes
+ganha três comandos que fazem a ponte entre o armazenamento local e a rede P2P —
+publish, fetch e status — comunicando-se com um tesd em execução através
+de um socket Unix.
O que foi construído
+Crate tesseras-rpc — Um novo crate compartilhado entre CLI e daemon.
+Define o protocolo RPC usando serialização MessagePack com enquadramento
+prefixado por tamanho (cabeçalho big-endian de 4 bytes, máximo de 64 MiB). Três
+tipos de requisição (Publish, Fetch, Status) e suas respostas
+correspondentes. Um DaemonClient síncrono gerencia a conexão do socket Unix
+com timeouts configuráveis. O protocolo é deliberadamente simples — uma
+requisição, uma resposta, conexão fechada — para manter a implementação
+auditável.
tes publish <hash> — Publica uma tessera na rede. Aceita hashes completos
+ou prefixos curtos (ex.: tes publish a1b2), que são resolvidos no banco de
+dados local. O daemon lê todos os arquivos da tessera do armazenamento, empacota
+em um único buffer MessagePack e entrega ao motor de replicação. Tesseras
+pequenas (< 4 MB) são replicadas como um único fragmento; maiores passam por
+codificação de apagamento Reed-Solomon. A saída mostra o hash curto e a contagem
+de fragmentos:
Published tessera 9f2c4a1b (24 fragments created)
+Distribution in progress — use `tes status 9f2c4a1b` to track.
+tes fetch <hash> — Busca uma tessera da rede usando o hash de conteúdo
+completo. O daemon coleta fragmentos disponíveis localmente, reconstrói os dados
+originais via decodificação de apagamento se necessário, desempacota os arquivos
+e armazena no CAS (content-addressable store). Retorna o número de memórias e o
+tamanho total buscado.
tes status <hash> — Exibe a saúde de replicação de uma tessera. A saída
+mapeia diretamente o modelo interno de saúde do motor de replicação:
| Estado | Significado |
|---|---|
| Local | Ainda não publicada — existe apenas na sua máquina |
| Publishing | Fragmentos sendo distribuídos, redundância crítica |
| Replicated | Distribuída, mas abaixo da redundância alvo |
| Healthy | Redundância completa alcançada |
Listener RPC no daemon — O daemon agora escuta em um socket Unix (padrão:
+$XDG_RUNTIME_DIR/tesseras/daemon.sock) com permissões de diretório adequadas
+(0700), limpeza de sockets obsoletos e shutdown gracioso. Cada conexão é tratada
+em uma task Tokio — o listener converte o stream assíncrono para I/O síncrono
+para a camada de enquadramento, despacha para o handler RPC e escreve a resposta
+de volta.
Pack/unpack no tesseras-core — Um módulo pequeno que serializa uma lista
+de entradas de arquivo (caminho + dados) em um único buffer MessagePack e
+vice-versa. Esta é a ponte entre a estrutura de diretórios da tessera e os blobs
+opacos do motor de replicação.
Decisões de arquitetura
+-
+
- Socket Unix ao invés de TCP: a comunicação RPC entre CLI e daemon acontece +na mesma máquina. Sockets Unix são mais rápidos, não precisam de alocação de +porta, e as permissões do sistema de arquivos fornecem controle de acesso sem +TLS. +
- MessagePack ao invés de JSON: o mesmo formato wire usado em todo o +Tesseras. Compacto, sem schema, e já é uma dependência do workspace. Uma +ida-e-volta típica de publish request/response ocupa menos de 200 bytes. +
- Cliente síncrono, daemon assíncrono: o
DaemonClientusa I/O bloqueante +porque o CLI não precisa de concorrência — envia uma requisição e espera. O +listener do daemon é assíncrono (Tokio) para tratar múltiplas conexões. A +camada de enquadramento funciona com qualquer implRead/Write, conectando +ambos os mundos.
+ - Resolução de prefixo no lado do cliente:
publishestatusresolvem +prefixos curtos localmente antes de enviar o hash completo ao daemon. Isso +mantém o daemon stateless — ele não precisa acessar o banco de dados do CLI.
+ - Alinhamento do diretório de dados padrão: o padrão do CLI mudou de
+
~/.tesseraspara~/.local/share/tesseras(viadirs::data_dir()) para +coincidir com o daemon. Um aviso de migração é exibido quando dados no caminho +antigo são detectados.
+
Próximos passos
+-
+
- Contagem de peers no DHT: o comando
statusatualmente reporta 0 peers — +conectar a contagem real do DHT é o próximo passo
+ tes show: exibir o conteúdo de uma tessera (memórias, metadados) sem +exportar
+- Fetch com streaming: para tesseras grandes, transmitir fragmentos conforme +chegam ao invés de esperar por todos +