Cosa registra una sessione di IA

Quasi tutto ciò che Pathrule impara sul tuo progetto lo impara dal lavoro, non dalla scrittura. Quando una sessione di IA termina un lavoro registra una breve voce strutturata, ed è proprio quella singola voce la base su cui poggiano diverse altre funzionalità.

Questa pagina spiega cosa contiene quella voce, cosa ne viene escluso di proposito e cosa alimenta in seguito.

Cosa viene registrato

Ogni voce è composta da pochi campi, tutti piccoli:

• Area, azione e ambito. Che tipo di elemento è stato toccato (ui, backend, database, infra, config, test, docs), che cosa gli è stato fatto (create, update, fix, refactor, delete, style) e a quale livello (un componente, una pagina, un'API, una migrazione, un servizio).
• Soggetti. Fino a cinque parole chiave in minuscolo, come quelle che useresti per etichettare il lavoro in una conversazione.
• Un riassunto di una frase. Cosa è cambiato e perché, in una riga.
• I percorsi toccati, raggruppati per area.
• Il client di IA in cui si è svolta la sessione, e quando.
• Com'è andato il turno: quante chiamate agli strumenti ha richiesto, quante sono fallite e un breve codice per ogni tipo di fallimento (timeout, exit_nonzero, not_found e simili). Solo conteggi e codici, mai il comando o il testo dell'errore.

Questa è l'intera registrazione. È pensata per essere leggibile a colpo d'occhio anche a distanza di mesi, ed è anche per questo che resta breve. La vista Recent Activity di Pathrule per VS Code elenca le voci più recenti del workspace.

La frase la scrive l'assistente, la misurazione la aggiunge Pathrule. Il riassunto, l'area e i percorsi provengono dalla sessione che ha svolto il lavoro, mentre il numero di chiamate agli strumenti, i fallimenti e quali delle voci consegnate sono state effettivamente consultate vengono osservati dal livello che le ha consegnate. Questa separazione è importante: un assistente può dimenticarsi di dire che quattro comandi sono falliti, ma il conteggio c'è comunque.

Cosa non viene mai registrato

Il tuo codice non c'è. Niente contenuti dei file, niente diff, niente patch, niente messaggi di commit e niente testo dei prompt. I percorsi ci sono perché le funzionalità successive possano capire dove si è svolto il lavoro; la sostanza della modifica non viene salvata.

I percorsi vengono inoltre normalizzati prima di essere salvati. Un percorso arriva così come l'agente lo vedeva su quella macchina e viene convertito in forma relativa al workspace, quindi /Users/you/projects/app/src/api.ts diventa src/api.ts. Nulla di specifico della macchina raggiunge la conoscenza condivisa del team, e lo stesso file resta lo stesso file chiunque l'abbia toccato.

Cosa alimenta una singola voce

Il motivo per cui vale la pena conservare questa registrazione sta in chi la legge:

• Episodi di lavoro. Le voci correlate di una stessa sessione di lavoro confluiscono in una registrazione con un titolo, dedicata a un problema che il tuo team ha risolto, che una sessione successiva può richiamare.
• File che cambiano insieme. Sono i percorsi di ogni voce a insegnare a Pathrule quali file si muovono in coppia.
• Apprendimento del recupero. Quando una conoscenza è stata messa davanti a un agente e l'agente ha poi lavorato in quella stessa area, questo è un indizio che la conoscenza era pertinente. Col tempo questo sposta le priorità, come descritto in come funziona il recupero.

Nessuna di queste funzionalità richiede un passaggio separato da parte tua. Derivano tutte dalla stessa breve voce.

La registrazione non blocca mai il lavoro

Vale la pena sottolineare una scelta progettuale deliberata, perché si riflette nel comportamento dello strumento. La registrazione non fallisce mai per una questione di dimensioni. Se un riassunto è troppo lungo o un'attività ha toccato decine di file, la voce viene troncata sul server e salvata, invece di essere rifiutata.

Rifiutarla sarebbe peggio che troncarla. Un agente che riceve un errore di validazione lo interpreta come "correggi gli argomenti e riprova", e passa i turni successivi a riscrivere un riassunto invece di portare a termine la tua attività. Per questo i limiti vengono applicati in modo silenzioso, in fase di ingresso, e la risposta comunica all'agente cosa è stato salvato.

A cosa servono i conteggi dei fallimenti

I conteggi delle chiamate agli strumenti e dei fallimenti sono il modo in cui Pathrule risponde alla domanda "in quali file di questo codice un assistente fa fatica" basandosi sul lavoro reale e non sulle opinioni. Sono due gli elementi che li leggono.

Il primo è un raggruppamento settimanale. Ogni fallimento viene registrato come una terna: il tipo di strumento, il file su cui stava lavorando e un breve codice che indica come è fallito. Raggruppato per settimana, diventa un semplice elenco dei file in cui un assistente fallisce più spesso e del tipo di fallimento che vi incontra. Un file che compare ripetutamente sotto file_not_found di solito indica un percorso obsoleto nella tua documentazione o un modulo spostato che nessuno ha aggiornato. Uno sotto syntax_error di solito è un file difficile da modificare in sicurezza.

Il secondo è l'apprendimento del recupero. Se un turno ha ricevuto conoscenza da Pathrule e ha comunque incontrato fallimenti degli strumenti, questo conta a sfavore della conoscenza fornita. Questo segnale entra nello stesso ciclo di apprendimento descritto in cosa fa salire di priorità la conoscenza, così la conoscenza che continua a comparire in turni andati male smette gradualmente di essere scelta.

Cosa può e non può vedere un conteggio dei fallimenti

Dipende dall'assistente che usi, e la risposta onesta non è la stessa per tutti.

Gli strumenti per i file riportano correttamente. Una lettura, una modifica o una scrittura fallita arriva con il suo messaggio, quindi viene classificata e attribuita al file giusto. È il caso più utile, perché è il percorso del file a rendere il numero utilizzabile in pratica.

Lo stato di uscita della shell spesso no. Alcuni assistenti non riportano affatto un codice di uscita diverso da zero: un comando che fallisce e uno che riesce arrivano identici. Pathrule non tira a indovinare. Registra ciò che l'assistente ha effettivamente riportato e classifica il resto come sconosciuto invece di inventare un fallimento, perché un fallimento sbagliato attribuito a un file è peggio di uno mancante.

Accesso e ambito

Le voci restano nel workspace in cui sono state registrate, protette dallo stesso controllo degli accessi per utente usato per memorie, regole e skill. Un collega vede l'attività dei workspace che può già vedere, e nient'altro. Le voci più vecchie scadono secondo una pianificazione invece di accumularsi all'infinito.