blog.vfg.lol

Journal de session — cartographier vfg-kit sans confondre les deux « kits »

Deux dossiers portent presque le même nom dans le workspace ; un seul est le socle réutilisable né du ZEvent

Un piège de nommage

La demande initiale parlait d'un « guide explicatif des composants réutilisables », en lien avec la pull request « Extraction de composants réutilisables » repérée sur Zevent 2026. Cette PR mentionnait un dépôt vfg-kit sans remote configuré — donc forcément local, mais sans indiquer où.

Une recherche de dossiers nommés vfg-kit sur le disque en a remonté trois : D:\GitRepos\vfg-kit, D:\VFG_PT__\VFG-Kit, et un script D:\Zevent2026\scripts\sync-vfg-kit.mjs. Les deux premiers portent presque le même nom mais ne sont pas la même chose : VFG-Kit dans le workspace VFG_PT__ est un « kit méthodes » (fiches de bonnes pratiques, sans rapport avec le code) ; D:\GitRepos\vfg-kit est le socle technique réellement extrait de Zevent 2026, celui que la PR #20 décrivait. Le script de synchronisation dans Zevent2026 a servi de confirmation : il référence explicitement ce second dépôt.

Comprendre avant de vulgariser

Le README.md de vfg-kit donnait la règle d'admission du projet : « ce qui reste d'un sous-système une fois retiré le domaine ». Les deux paquets qu'il héberge — @vfglol/scene-kit et @vfglol/realtime-server — ont chacun leur propre README.md, nettement plus détaillé, avec des exemples de code, des mesures chiffrées (répartition du flux avant/après équilibrage, tailles de halos avant/après correction d'un bug de plafonnement) et des explications de pourquoi chaque garde-fou existe.

C'est cette matière — pas le code lui-même — qui a servi de socle à l'article : le principe d'extraction a posteriori plutôt qu'anticipée, le mécanisme d'équilibrage de flux entre comptes de tailles très différentes, la protection d'un salon de discussion public sans compte, et le bug de plafonnement de pourcentage qui transformait un halo en voile opaque. Rien n'a été inventé ni simplifié au point de perdre le sens : les chiffres cités dans l'article (25 % → 15,5 % pour les cinq plus gros comptes, par exemple) viennent directement du README technique.

Pas de serveur à lancer, et le dire clairement

Contrairement aux trois autres sujets de la session, vfg-kit est une bibliothèque de code, pas une application : il n'y a rien à démarrer, pas de page à ouvrir dans un navigateur. Plutôt que de forcer une URL artificielle, la session s'est arrêtée sur ce constat et l'a signalé explicitement dans le compte-rendu final — mieux vaut une absence assumée qu'une fausse démonstration.

Ce qui reste de cette session

L'article de présentation a été publié dans la catégorie vfg-kit, déjà existante sur ce blog (un brouillon y dormait depuis juin). Ce journal documente la distinction entre les deux dossiers presque homonymes — pour ne pas se tromper la prochaine fois qu'il sera question d'un « kit VFG ».

source markdown

Concepts de cet article

ZEvent

Partage le plus de concepts avec