Skip to content

feat(glossary): mise en place du glossaire mécanique + système de migration

Marc Fanous requested to merge llm-glossary into main

Résumé

Mise en place du glossaire mécanique du wiki, inspirée du travail fait sur la branche glossaire de fyl-guidelines (git.oxyl.fr/BPI/FYL/fyl-guidelines!47 et sa branche de base), adaptée plutôt que recalquée telle quelle.

  • Pipeline générique (scripts/generate-glossary.mjs + scripts/wiki-glossary/{fileWalker,logUndefinedAndStale}.mjs) : régénère wiki/shared/glossary.json depuis raw/**/*.md + wiki/**/*.md, mécaniquement, jamais de LLM. Aucun extracteur concret fourniscripts/wiki-glossary/parsers/index.mjs est un registre vide avec le contrat documenté ; chaque wiki y ajoute ses propres parsers selon ses besoins.
  • Pas de module de fusion cross-source (merge.mjs supprimé) : un parser reçoit tout le corpus en un seul appel et doit consolider lui-même ses résultats — un wiki avec un seul extracteur n'a besoin d'aucune fusion.
  • wiki.config.json gagne un champ optionnel glossary: {enabled, path} — purement additif, pas de migration nécessaire (voir migrations/README.md, nouvelle section sur l'adoption du glossaire pour un wiki existant).
  • agents/ingest : extraction du glossaire + vérification avant d'écrire une définition sont des étapes obligatoires (Steps 3 et 5), pour ne jamais halluciner une définition déjà connue.
  • agents/consolidate-glossary (nouveau, optionnel, à la demande) : trie le backlog description: null — propose ou rejette, ne résout jamais un conflicts, ne se promeut jamais lui-même.
  • Docs mises à jour : README.md, docs/wiki.config.md, docs/llm-wiki-INGESTION_GUIDE.md, docs/llm-wiki-schema.md, migrations/README.md.
  • npm test (nouveau, node --test) : 9 tests couvrant la découverte de fichiers et la gestion des collisions d'id.

🤖 Generated with Claude Code

Merge request reports

Loading