Mostrar HN: WUPHF — Wiki de LLM al estilo Karpathy con Markdown + Git como fuente de verdad

WUPHF es una oficina colaborativa de código abierto para agentes de IA (Claude Code, Codex, OpenClaw, LLMs locales vía OpenCode) que incluye una capa wiki estilo Karpathy. El wiki usa Markdown y Git como fuente de verdad, almacenados en ~/.wuphf/wiki/, con un índice bleve (BM25) + SQLite encima. Aún no se usa base de datos vectorial ni de grafos; el objetivo es ver hasta dónde pueden llegar Markdown + Git antes de agregar infraestructura más pesada.

Características principales

• Cada agente tiene un cuaderno privado en agents/{slug}/notebook/ más un wiki de equipo compartido en team/.
• Flujo de promoción de borrador a wiki: las entradas del cuaderno son revisadas (por agente o humano) y promovidas al wiki canónico con enlaces inversos. Una máquina de estados maneja la caducidad y el archivado automático.
• Registro de hechos por entidad: JSONL de solo añadir en team/entities/{kind}-{slug}.facts.jsonl. Un trabajador de síntesis reconstruye los resúmenes de entidad cada N hechos.
• Los commits se atribuyen a una identidad Git distinta («Pam the Archivist») para trazabilidad vía git log.
• [[Wikilinks]] con detección de enlaces rotos (mostrados en rojo).
• Cron de lint diario para contradicciones, entradas obsoletas y wikilinks rotos.
• Comando slash /lookup + herramienta MCP para recuperación citada. Un clasificador heurístico dirige consultas cortas a BM25 y consultas narrativas a un bucle de respuesta citada.

Ajuste de recuperación

El benchmark actual con 500 artefactos y 50 consultas alcanza un 85 % de recall@20 solo con BM25, que es el umbral interno de lanzamiento. Si una clase de consulta cae por debajo de eso, sqlite-vec es la alternativa predefinida.

Decisiones de infraestructura

• Markdown por durabilidad: el wiki sobrevive al tiempo de ejecución; los usuarios pueden hacer git clone y llevarse cada byte.
• Bleve para BM25.
• SQLite para metadatos estructurados (hechos, entidades, aristas, redirecciones, sustituciones).
• Los IDs canónicos son de primera clase: los IDs de hechos son deterministas (incluyen el offset de la oración), los slugs se asignan una vez y nunca se renombran (se usan stubs de redirección). La reconstrucción es lógicamente idéntica, no byte a byte.

Limitaciones conocidas

• El 85 % de recall no es una garantía universal: el ajuste continúa.
• La calidad de la síntesis depende de la calidad de las observaciones del agente. El pase de lint ayuda pero no es un motor de juicio.
• Ámbito de oficina única; aún no hay federación entre oficinas.

Demo e instalación

Hay un recorrido de terminal de 5 minutos en asciinema (script en ./scripts/demo-entity-synthesis.sh).

Instalar con: npx wuphf@latest

Compilar desde fuente: git clone https://github.com/nex-crm/wuphf.git; go build -o wuphf ./cmd/wuphf

El wiki se distribuye como parte de WUPHF pero se puede usar de forma independiente. Licencia MIT, autoalojado, traiga sus propias claves.