Citation Fixer

• Vos pages brain accumulent des faits avec des citations [Source : ...] manquantes ou au format incohérent et vous souhaitez un audit systématique plutôt qu'une révision manuelle.
• Vous avez des pages qui font référence à des tweets, des posts X ou des retweets en citant du texte ou en mentionnant des métriques d'engagement, mais sans véritable URL x.com — Citation Fixer peut rechercher et corriger automatiquement ces liens via l'intégration de l'API X de l'hôte.
• Vous souhaitez un balayage hebdomadaire récurrent (mode cron) pour détecter les nouvelles lacunes de citation au fur et à mesure que d'autres compétences comme enrich ou media-ingest ajoutent du contenu.
• Une autre compétence doit valider sa propre sortie avant de la valider — Citation Fixer peut être appelé par programmation en tant que vérification pré-commit.

• Votre cerveau n'a aucune convention de citation en place — la compétence compare les citations avec conventions/quality.md, donc sans cette norme, les corrections n'ont aucun format cible à appliquer.
• Vous avez besoin que des références à des tweets soient résolues, mais l'hôte ne dispose d'aucune intégration API X/Twitter configurée — le pipeline de résolution de tweets dépend entièrement de cette recette côté hôte et n'inventera pas d'URLs.
• Vous recherchez une compétence qui supprime ou efface automatiquement les faits non cités — Citation Fixer signale les lacunes mais ne supprime jamais le contenu.

Liste et lit chaque page du cerveau, en vérifiant la présence de citations intégrées [Source: ...] dans chacune d'elles. Génère un résumé structuré : pages analysées, citations trouvées, problèmes corrigés et lacunes restantes.

Réécrit les citations auxquelles il manque une date, un type de source, ou qui ne correspondent pas au format défini dans conventions/quality.md. Corrige uniquement le format — n'invente jamais une source qui n'existe pas.

Détecte les références de tweets incorrectes — texte cité, métriques d'engagement, ou entrées [Source: X/Twitter ...] dépourvues d'une URL x.com/status/ — puis interroge l'intégration API X de l'hôte pour retrouver le vrai tweet. Insère un lien déterministe https://x.com/<handle>/status/<tweet_id> accompagné des métadonnées d'engagement vérifiées.

Toutes les URL sont construites à partir des données renvoyées par l'API X ; la compétence ne devine jamais un identifiant de tweet et n'en compose pas. Cette règle est appliquée comme une contrainte de sortie stricte afin d'empêcher les liens hallucinés de pénétrer dans le cerveau.

Cible environ 50 pages par exécution de lot, effectue des validations toutes les 10 à 20 pages afin d'éviter toute perte de progression en cas d'échec partiel, et respecte les limites du niveau API X de l'hébergeur. Ordre de priorité : pages récemment mises à jour en premier, puis pages à fort trafic, puis nettoyage en masse.

Lors d'une exécution en lot récurrente, Citation Fixer enregistre la progression dans ~/.gbrain/citation-fixer-state.json, en suivant les pages analysées, les citations corrigées, les liens de tweets résolus et les lacunes non résolubles entre les exécutions.

Exécutez Citation Fixer selon un calendrier cron pour détecter les nouvelles lacunes introduites par d'autres compétences ou des modifications manuelles. Le rapport d'audit fournit un décompte clair des faits non cités restants, afin que rien ne s'accumule silencieusement.

Si votre base de connaissances a été alimentée à partir de résumés de réseaux sociaux ou d'ingestion de médias, de nombreuses pages peuvent citer des tweets sans URL réelles. Le mode batch de Citation Fixer identifie les pages candidates et les corrige avec des liens x.com vérifiés via l'API X.

Des compétences telles que enrich ou media-ingest peuvent appeler Citation Fixer avant d'écrire des pages dans le cerveau, garantissant ainsi que chaque nouvelle page respecte les normes de citation avant d'être validée.

Déclenchez manuellement avec « fix citations on this page » pour auditer et corriger une page spécifique sans lancer une analyse complète — utile lors de la révision ou de la publication d'une entrée très visible.