Citation Fixer

• Le tue pagine brain stanno accumulando fatti con citazioni [Source: ...] mancanti o formattate in modo incoerente e vuoi un audit sistematico invece di una revisione manuale.
• Hai pagine che fanno riferimento a tweet, post X o retweet citando del testo o menzionando metriche di engagement ma senza un vero URL x.com — Citation Fixer può cercare e correggere automaticamente quei link tramite l'integrazione X API dell'host.
• Vuoi una scansione ricorrente settimanale (modalità cron) per individuare nuove lacune nelle citazioni man mano che altre skill come enrich o media-ingest aggiungono contenuti.
• Un'altra skill deve validare il proprio output prima di eseguire il commit — Citation Fixer può essere richiamato programmaticamente come controllo pre-commit.

• Il tuo cervello non ha nessuna convenzione di citazione impostata — la skill confronta le citazioni con conventions/quality.md, quindi senza quello standard le correzioni non hanno un formato di destinazione da applicare.
• Hai bisogno di risolvere riferimenti a tweet ma l'host non ha nessuna integrazione con le API di X/Twitter configurata — la pipeline di risoluzione dei tweet dipende interamente da quella ricetta lato host e non inventerà URL.
• Stai cercando una skill che rimuova o elimini automaticamente i fatti non citati — Citation Fixer segnala le lacune ma non elimina mai i contenuti.

Elenca e legge ogni pagina del cervello, verificando la presenza di citazioni inline [Source: ...] in ciascuna. Genera un riepilogo strutturato: pagine analizzate, citazioni trovate, problemi risolti e lacune rimanenti.

Riscrive le citazioni a cui manca una data, un tipo di fonte, o che non corrispondono al formato definito in conventions/quality.md. Corregge solo il formato — non inventa mai una fonte che non esiste.

Rileva riferimenti a tweet non funzionanti — testo citato, metriche di coinvolgimento o voci [Source: X/Twitter ...] prive di un URL x.com/status/ — quindi esegue una ricerca tramite l'integrazione X API dell'host per trovare il tweet reale. Inserisce un link deterministico https://x.com/<handle>/status/<tweet_id> insieme ai metadati di coinvolgimento verificati.

Tutti gli URL vengono costruiti a partire dai dati restituiti dall'API di X; la skill non indovina né compone mai un ID di tweet. Questa è una regola di output rigida, applicata per impedire che link allucinati entrino nel cervello.

Elabora circa 50 pagine per ogni esecuzione batch, esegue il commit ogni 10–20 pagine per evitare la perdita di progressi in caso di errori parziali, e rispetta i limiti del tier API X dell'host. Ordine di priorità: prima le pagine aggiornate di recente, poi le pagine ad alto traffico, infine la pulizia in blocco.

Quando viene eseguito come batch ricorrente, Citation Fixer memorizza i progressi in ~/.gbrain/citation-fixer-state.json, tenendo traccia delle pagine analizzate, delle citazioni corrette, dei link tweet risolti e delle lacune irrisolvibili tra le varie esecuzioni.

Esegui Citation Fixer con una pianificazione cron per individuare le nuove lacune introdotte da altre competenze o modifiche manuali. Il rapporto di verifica fornisce un conteggio chiaro dei fatti ancora privi di citazione, così nulla si accumula silenziosamente.

Se il tuo sistema è stato popolato da sintesi di social media o dall'acquisizione di contenuti multimediali, molte pagine potrebbero citare tweet senza URL reali. La modalità batch di Citation Fixer identifica le pagine candidate e le aggiorna con link x.com verificati tramite le API di X.

Skill come enrich o media-ingest possono chiamare Citation Fixer prima di scrivere le pagine nel brain, assicurando che ogni nuova pagina soddisfi gli standard di citazione prima che venga salvata.

Attiva manualmente con "fix citations on this page" per verificare e correggere una pagina specifica senza eseguire una scansione completa — utile durante la revisione o la pubblicazione di una voce ad alta visibilità.