3 novembre 2026

hermes-memory-pgvector 1.0.2 : code testé, versions traçables

hermes-memory-pgvector 1.0.2 : code testé, versions traçables

hermes-memory-pgvector 1.0.2 est disponible, avec des contrôles plus stricts sur le code et sur les fichiers que les utilisateurs installent depuis PyPI. La suite en direct réussit 789 tests sans aucun test ignoré. Chaque instruction exécutable du package d’exécution est couverte, et les deux archives publiées comportent désormais une provenance vérifiable.

Cette version fait suite à notre article de la version 1.0, qui a introduit l’interface publique stable du projet. La version 1.0.2 conserve cette interface et ce schéma de base de données inchangés, tout en renforçant le processus qui permet aux modifications d’aboutir à une version.

Mémoire partagée pour les agents qui collaborent

Ce plugin fournit à hermes-agent de Nous Research une couche de stockage PostgreSQL et pgvector. Les agents continuent d’utiliser l’outil de mémoire intégré. Le fournisseur réplique ces écritures et stocke les échanges de conversation porteurs d’informations significatives à des fins de rappel sémantique.

La mémoire reste limitée au thème de l’agent courant, sauf si un rappel entre thèmes est explicitement demandé. Les embeddings sont calculés sans LLM dans le chemin critique de la mémoire, et les écritures sont mises en file d’attente afin que le thread de l’agent n’attende pas les opérations d’embedding ou de base de données.

Couverture de tests avec un plancher imposé

Les nouveaux tests couvrent les opérations de stockage et les situations de concurrence, l’isolation des identités, le rappel, la maintenance en ligne de commande, les erreurs HTTP, l’arrêt du processus d’écriture et les échecs à la frontière de l’intégration avec l’hôte.

Les résultats mesurés sont les suivants :

  • 789 tests réussis, avec aucun test ignoré dans la suite en direct.
  • 100% de couverture des instructions sur les six modules d’exécution.
  • 99.66% de couverture des branches, ou 99.92% de couverture combinée des instructions et des branches.
  • Un planchier de couverture combinée de 99.5% imposé dans l’intégration continue en direct.

Deux issues de branche restent visibles dans le rapport. L’une nécessiterait une boucle de nouvelle tentative avec zéro itération, alors qu’elle tente toujours au moins une fois. L’autre nécessiterait que le texte de délégation généré soit vide ou constitué de bruit, alors qu’il inclut toujours un préfixe de délégation fixe. Aucun code d’exécution n’a été exclu pour augmenter le pourcentage.

La couverture consigne les chemins que les tests ont empruntés ; elle ne prouve pas qu’un programme est dépourvu de bugs. Les tests ont besoin d’assertions utiles et de cas d’échec réalistes. La suite est exécutée avec PostgreSQL 16, 17 et 18, ainsi que des tests unitaires sous Python 3.11, 3.12 et 3.13 et des contrôles de conformité amont dont la version est figée.

Deux défaillances restent désormais confinées au fournisseur

Les tests ont mis en évidence deux endroits où une exception pouvait remonter dans la boucle de l’agent : la construction du magasin de base de données lors de l’initialisation et la planification d’une écriture en mémoire via le processus d’écriture en arrière-plan.

La version 1.0.2 intercepte les deux exceptions et les journalise. Un échec de construction du magasin laisse le fournisseur indisponible ; un échec de mise en file d’attente dégrade le hook d’écriture. Ni l’un ni l’autre chemin n’ajoute d’opérations synchrones d’embedding ou de base de données au thread de l’agent.

Les règles Ruff, les hooks de commit locaux, les contrôles de protection de la branche principale et les contrôles de version et de configuration appliquent désormais les mêmes exigences avant la publication des modifications.

Retracez l’origine du paquet que vous installez

Le wheel et l’archive source sur PyPI sont tous deux assortis d’attestations de publication créées au moyen de Trusted Publishing. GitHub consigne également la provenance de compilation des deux fichiers. Le workflow de publication compare le contenu des archives à celui du checkout source avant de les téléverser.

Nous avons vérifié les deux attestations de PyPI par rapport au dépôt et confirmé que les fichiers de PyPI ont les mêmes valeurs de hachage que les artefacts de la version GitHub.

La provenance permet à un lecteur de vérifier d’où provient un fichier. Elle complète la revue de code et les tests ; elle ne certifie pas que le code est correct.

Mettre à niveau vers 1.0.2

Dans l’environnement Python qui exécute votre agent :

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

Redémarrez les processus Hermes qui chargent le fournisseur, puis lancez hermes memory status. Il n’y a aucune nouvelle migration ni aucun changement de schéma de 1.0.1 à 1.0.2. Pour une installation neuve ou un déploiement antérieur, suivez les instructions d’installation et de mise à niveau du dépôt.

Le projet est open source sous licence BSD-3-Clause, avec droits d’auteur Green Yoga Inc.