3 novembre 2026

hermes-memory-pgvector 1.0.2: Codice testato, release tracciabili

hermes-memory-pgvector 1.0.2: Codice testato, release tracciabili

La versione hermes-memory-pgvector 1.0.2 è disponibile, con controlli più rigorosi sia sul codice sia sui file che gli utenti installano da PyPI. La suite del database in esecuzione completa 789 test senza test saltati. Ogni istruzione eseguibile del pacchetto runtime è coperta e entrambi gli archivi pubblicati ora hanno una provenienza verificabile.

Questo segue il nostro articolo della release 1.0, che ha introdotto l'interfaccia pubblica stabile del progetto. La versione 1.0.2 mantiene invariati l'interfaccia e lo schema del database, rendendo più rigoroso il processo attraverso cui le modifiche raggiungono una release.

Memoria condivisa per agenti che collaborano

Il plugin fornisce a hermes-agent di Nous Research un livello di archiviazione PostgreSQL e pgvector. Gli agenti continuano a usare lo strumento di memoria integrato. Il provider replica queste scritture e memorizza i turni di conversazione con contenuto significativo per il richiamo semantico.

La memoria resta circoscritta al tema dell'agente corrente, a meno che non venga richiesto esplicitamente il richiamo tra temi. Gli embedding vengono elaborati senza un LLM nel percorso critico della memoria e le scritture vengono accodate, così il thread dell'agente non deve attendere le operazioni di embedding o del database.

Copertura dei test con una soglia minima obbligatoria

I nuovi test coprono le operazioni di archiviazione e le condizioni di gara, l'isolamento delle identità, il richiamo, la manutenzione tramite riga di comando, gli errori HTTP, l'arresto del writer e i guasti al confine dell'integrazione con l'host.

I risultati misurati sono:

  • 789 test superati, con zero test saltati nella suite in esecuzione.
  • 100% di copertura delle istruzioni in tutti e sei i moduli runtime.
  • 99.66% di copertura dei rami, oppure 99.92% di copertura combinata di istruzioni e rami.
  • Una soglia minima obbligatoria di 99.5% per la copertura combinata nella CI live.

Nel report restano visibili due esiti relativi ai rami. Uno richiederebbe un ciclo di retry con zero iterazioni, sebbene tenti sempre almeno una volta. L'altro richiederebbe che il testo di delega generato fosse vuoto o composto da rumore, sebbene includa sempre un prefisso di delega fisso. Nessun codice runtime è stato escluso per far salire la percentuale.

La copertura registra quali percorsi i test hanno esercitato; non dimostra che un programma sia privo di bug. I test richiedono asserzioni utili e casi di guasto realistici. La suite viene eseguita su PostgreSQL 16, 17 e 18, insieme a test unitari per Python 3.11, 3.12 e 3.13 e controlli di conformità upstream ancorati a versioni specifiche.

Due guasti ora restano contenuti nel provider

I test hanno individuato due punti in cui un'eccezione poteva propagarsi fino al ciclo dell'agente: la costruzione dello store del database durante l'inizializzazione e la pianificazione di una scrittura in memoria tramite il writer in background.

La versione 1.0.2 intercetta e registra entrambe le eccezioni. Un errore durante la costruzione dello store lascia il provider non disponibile; un errore di accodamento degrada l'hook di scrittura. Nessuno dei due percorsi aggiunge al thread dell'agente operazioni sincrone di embedding o sul database.

Le regole Ruff, gli hook di commit locali, i controlli sul main protetto e i controlli di versione e configurazione ora impongono le stesse aspettative prima che le modifiche vengano rilasciate.

Traccia il pacchetto che installi

Sia la wheel sia l'archivio del codice sorgente su PyPI dispongono di attestazioni di pubblicazione create tramite Trusted Publishing. GitHub registra inoltre la provenienza della build di entrambi i file. Il workflow di rilascio verifica che il contenuto degli archivi corrisponda al checkout del sorgente prima di caricarli.

Abbiamo verificato entrambe le attestazioni di pubblicazione su PyPI rispetto al repository e controllato che i file su PyPI avessero gli stessi hash degli asset della release di GitHub.

La provenienza consente al lettore di verificare l'origine di un file. È complementare alla revisione del codice e ai test; non certifica che il codice sia corretto.

Aggiorna alla versione 1.0.2

Nell'ambiente Python che esegue il tuo agente:

python -m pip install --upgrade hermes-memory-pgvector==1.0.2

Riavvia i processi Hermes che caricano il provider, poi controlla hermes memory status. Tra 1.0.1 e 1.0.2 non ci sono nuove migrazioni o modifiche allo schema. Per un'installazione nuova o un deployment di una versione precedente, segui le istruzioni di installazione e aggiornamento del repository.

Il progetto è open source con licenza BSD-3-Clause, copyright Green Yoga Inc.