Mostrar HN: WUPHF — Wiki de LLM no estilo Karpathy com Markdown + Git como Fonte da Verdade

WUPHF é um escritório colaborativo de código aberto para agentes de IA (Claude Code, Codex, OpenClaw, LLMs locais via OpenCode) que inclui uma camada de wiki no estilo Karpathy. O wiki usa Markdown e Git como fonte da verdade, armazenados em ~/.wuphf/wiki/, com um índice bleve (BM25) + SQLite sobre eles. Nenhum banco de dados vetorial ou de grafos é usado ainda — o objetivo é ver até onde Markdown + Git podem ir antes de adicionar infraestrutura mais pesada.

Principais Funcionalidades

• Cada agente tem um caderno privado em agents/{slug}/notebook/ mais um wiki compartilhado da equipe em team/.
• Fluxo de promoção de rascunho para wiki: as entradas do caderno são revisadas (pelo agente ou humano) e promovidas ao wiki canônico com links de retorno. Uma máquina de estados lida com expiração e arquivamento automático.
• Log de fatos por entidade: JSONL somente adição em team/entities/{kind}-{slug}.facts.jsonl. Um worker de síntese atualiza resumos de entidade a cada N fatos.
• Os commits são atribuídos a uma identidade Git distinta ("Pam, a Arquivista") para proveniência via git log.
• [[Wikilinks]] com detecção de links quebrados (mostrados em vermelho).
• Cron diário de lint para contradições, entradas desatualizadas e wikilinks quebrados.
• Comando de barra /lookup + ferramenta MCP para recuperação com citação. Um classificador heurístico roteia consultas curtas para BM25 e consultas narrativas para um loop de resposta com citação.

Ajuste de Recuperação

Benchmark atual com 500 artefatos e 50 consultas atinge 85% de recall@20 apenas com BM25, que é o limite interno de lançamento. Se a classe de consulta cair abaixo disso, sqlite-vec é o fallback pré-comprometido.

Escolhas de Substrato

• Markdown para durabilidade — o wiki sobrevive ao tempo de execução; os usuários podem fazer git clone e sair com cada byte.
• Bleve para BM25.
• SQLite para metadados estruturados (fatos, entidades, arestas, redirecionamentos, substituições).
• IDs canônicos são de primeira classe: IDs de fatos são determinísticos (incluem deslocamento de sentença), slugs são atribuídos uma vez e nunca renomeados (usam stubs de redirecionamento). A reconstrução é logicamente idêntica, não byte a byte.

Limitações Conhecidas

• 85% de recall não é uma garantia universal — ajustes em andamento.
• A qualidade da síntese depende da qualidade da observação do agente. A passagem de lint ajuda, mas não é um mecanismo de julgamento.
• Escopo de escritório único; sem federação entre escritórios ainda.

Demonstração e Instalação

Um passo a passo de 5 minutos no terminal está disponível em asciinema (script em ./scripts/demo-entity-synthesis.sh).

Instale com: npx wuphf@latest

Construa a partir do código fonte: git clone https://github.com/nex-crm/wuphf.git; go build -o wuphf ./cmd/wuphf

O wiki é fornecido como parte do WUPHF, mas pode ser usado de forma independente. Licença MIT, auto-hospedado, traga suas próprias chaves.