HN : WUPHF — Wiki LLM style Karpathy avec Markdown + Git comme source de vérité

WUPHF est un bureau collaboratif open-source pour les agents IA (Claude Code, Codex, OpenClaw, LLM locaux via OpenCode) qui inclut une couche wiki de style Karpathy. Le wiki utilise Markdown et Git comme source de vérité, stockée dans ~/.wuphf/wiki/, avec un index bleve (BM25) + SQLite par-dessus. Aucune base vectorielle ou graphe n'est encore utilisée — l'objectif est de voir jusqu'où Markdown + Git peuvent aller avant d'ajouter une infrastructure plus lourde.

Fonctionnalités clés

• Chaque agent dispose d'un carnet privé dans agents/{slug}/notebook/ plus un wiki d'équipe partagé dans team/.
• Processus de promotion du brouillon au wiki : les entrées du carnet sont révisées (par l'agent ou un humain) et promues au wiki canonique avec des rétroliens. Un automate gère l'expiration et l'archivage automatique.
• Journal de faits par entité : JSONL en mode append-only dans team/entities/{kind}-{slug}.facts.jsonl. Un worker de synthèse reconstruit les résumés d'entité tous les N faits.
• Les commits sont attribués à une identité Git distincte ("Pam the Archivist") pour la traçabilité via git log.
• [[Wikiliens]] avec détection de liens brisés (affichés en rouge).
• Cron de lint quotidien pour les contradictions, les entrées obsolètes et les wikiliens brisés.
• Commande slash /lookup + outil MCP pour une recherche citée. Un classifieur heuristique oriente les requêtes courtes vers BM25 et les requêtes narratives vers une boucle de réponse citée.

Ajustement de la recherche

Le benchmark actuel avec 500 artefacts et 50 requêtes atteint 85% de rappel@20 sur BM25 seul, ce qui est le seuil interne de validation. Si une classe de requêtes tombe en dessous, sqlite-vec est le repli pré-engagé.

Choix de substrat

• Markdown pour la durabilité — le wiki survit à l'exécution ; les utilisateurs peuvent git clone et repartir avec chaque octet.
• Bleve pour BM25.
• SQLite pour les métadonnées structurées (faits, entités, arêtes, redirections, remplacements).
• Les identifiants canoniques sont de première classe : les identifiants de faits sont déterministes (incluent le décalage de phrase), les slugs sont attribués une fois et jamais renommés (des stubs de redirection sont utilisés). La reconstruction est logiquement identique, pas octet par octet.

Limites connues

• 85% de rappel n'est pas une garantie universelle — l'ajustement est en cours.
• La qualité de synthèse dépend de la qualité d'observation de l'agent. Le passage de lint aide mais n'est pas un moteur de jugement.
• Périmètre mono-bureau ; pas encore de fédération entre bureaux.

Démo et installation

Une démonstration en terminal de 5 minutes est disponible sur asciinema (script dans ./scripts/demo-entity-synthesis.sh).

Installation avec : npx wuphf@latest

Compilation à partir des sources : git clone https://github.com/nex-crm/wuphf.git; go build -o wuphf ./cmd/wuphf

Le wiki fait partie de WUPHF mais peut être utilisé de manière autonome. Licence MIT, auto-hébergé, apportez vos propres clés.