hermes-memory-pgvector 1.0.2 ist erschienen, mit strengeren Prüfungen sowohl für den Code als auch für die Dateien, die Menschen von PyPI installieren. Die Live-Datenbank-Testsuite besteht 789 Tests, ohne einen einzigen zu überspringen. Jede ausführbare Anweisung im Laufzeitpaket ist abgedeckt, und beide veröffentlichten Archive verfügen nun über eine überprüfbare Provenienz.
Dieser Release folgt unserem Artikel zum Release 1.0, der die stabile öffentliche Schnittstelle des Projekts einführte. Version 1.0.2 lässt diese Schnittstelle und das Datenbankschema unverändert und verschärft gleichzeitig den Ablauf, über den Änderungen zu einem Release gelangen.
Geteilter Speicher für kooperierende Agenten
Das Plugin stellt hermes-agent von Nous Research eine Speicherschicht für PostgreSQL und pgvector bereit. Agenten verwenden weiterhin das integrierte Memory-Tool. Der Provider spiegelt diese Schreibvorgänge und speichert wesentliche Gesprächsbeiträge für den semantischen Abruf.
Der Speicher bleibt auf das aktuelle Thema des Agenten beschränkt, sofern nicht ausdrücklich ein themenübergreifender Abruf angefordert wird. Embeddings werden im Hot Path des Speichers ohne LLM berechnet, und Schreibvorgänge werden eingereiht, sodass der Agent-Thread nicht auf Embedding- oder Datenbankoperationen warten muss.
Testabdeckung mit verbindlicher Untergrenze
Die neuen Tests decken Speicheroperationen und Race Conditions, Identitätsisolierung, Abruf, Wartung über die Befehlszeile, HTTP-Fehler, den Shutdown des Writers sowie Fehler an der Integrationsgrenze zum Host ab.
Die gemessenen Ergebnisse lauten:
- 789 bestandene Tests, ohne in der Live-Suite einen einzigen Test zu überspringen.
- 100% Anweisungsabdeckung über alle sechs Laufzeitmodule.
- 99.66% Branch-Coverage oder 99.92% kombinierte Anweisungs- und Branch-Coverage.
- Eine verbindliche 99.5% kombinierte Coverage-Untergrenze in der Live-CI.
Im Bericht bleiben zwei Branch-Ergebnisse sichtbar. Das eine würde eine Retry-Schleife mit null Iterationen erfordern, obwohl sie stets mindestens einen Versuch unternimmt. Das andere würde erfordern, dass der generierte Delegationstext leer oder Rauschen ist, obwohl er stets einen festen Delegationspräfix enthält. Zur Erhöhung des Prozentsatzes wurde kein Laufzeitcode ausgeschlossen.
Die Coverage dokumentiert, welche Pfade die Tests durchlaufen haben; sie beweist nicht, dass ein Programm fehlerfrei ist. Tests benötigen sinnvolle Assertions und realistische Fehlerfälle. Die Suite läuft gegen PostgreSQL 16, 17 und 18, zusammen mit Unit-Tests für Python 3.11, 3.12 und 3.13 sowie Upstream-Conformance-Prüfungen mit festgelegten Versionen.
Zwei Ausfälle bleiben nun innerhalb des Providers
Die Tests deckten zwei Stellen auf, an denen eine Ausnahme in die Agentenschleife entweichen konnte: das Erstellen des Datenbank-Stores während der Initialisierung und die Einplanung eines Memory-Schreibvorgangs über den Hintergrund-Writer.
Version 1.0.2 fängt beide Ausnahmen ab und protokolliert sie. Ein Fehler beim Erstellen des Stores führt dazu, dass der Provider nicht verfügbar ist; ein Fehler beim Einreihen beeinträchtigt den Write-Hook. Keiner der beiden Pfade fügt synchrone Embedding- oder Datenbankarbeit zum Agent-Thread hinzu.
Ruff-Regeln, lokale Commit-Hooks, Prüfungen für den geschützten Main-Branch sowie Versions- und Konfigurationsprüfungen setzen nun dieselben Anforderungen durch, bevor Änderungen ausgeliefert werden.
Herkunft des installierten Pakets verfolgen
Sowohl das Wheel als auch das Quellarchiv auf PyPI verfügen über Publish-Attestierungen, die über Trusted Publishing erstellt wurden. GitHub erfasst außerdem die Build-Provenienz für beide Dateien. Der Release-Workflow prüft vor dem Upload die Inhalte der Archive gegen den Quell-Checkout.
Wir haben beide PyPI-Attestierungen gegen das Repository verifiziert und geprüft, ob die PyPI-Dateien dieselben Hashes wie die GitHub-Release-Assets aufweisen.
Die Provenienz ermöglicht es Leserinnen und Lesern, die Herkunft einer Datei zu überprüfen. Sie ergänzt Code-Review und Tests; sie bescheinigt nicht, dass der Code korrekt ist.
Auf 1.0.2 aktualisieren
In der Python-Umgebung, in der Ihr Agent ausgeführt wird:
python -m pip install --upgrade hermes-memory-pgvector==1.0.2
Starten Sie die Hermes-Prozesse neu, die den Provider laden, und führen Sie anschließend hermes memory status aus. Zwischen 1.0.1 und 1.0.2 gibt es keine neuen Migrationen oder Schemaänderungen. Befolgen Sie für eine Neuinstallation oder eine ältere Bereitstellung die Installations- und Upgrade-Anweisungen des Repositorys.
- PyPI-Release und Dateiprovenienz
- GitHub-Release
- Quellcode und Installationsanweisungen
- Änderungsprotokoll
Das Projekt ist unter BSD-3-Clause quelloffen, Copyright Green Yoga Inc.
