2026年11月3日

hermes-memory-pgvector 1.0.2: テスト済みコード、追跡可能なリリース

hermes-memory-pgvector 1.0.2: テスト済みコード、追跡可能なリリース

hermes-memory-pgvector 1.0.2 がリリースされ、コードとユーザーがPyPIからインストールするファイルの両方に対して、より厳格なチェックが行われるようになりました。ライブデータベーススイートでは、789件のテストがスキップなしで成功しています。ランタイムパッケージの実行可能なすべてのステートメントがカバーされ、公開された両アーカイブには検証可能なプロベナンスが付与されています。

これは、当プロジェクトの安定した公開インターフェースを紹介した1.0リリース記事に続くリリースです。バージョン1.0.2では、そのインターフェースとデータベーススキーマを変更せず、変更がリリースに到達する過程をより厳密にしています。

連携エージェントのための共有メモリ

このプラグインはNous Researchのhermes-agentにPostgreSQLおよびpgvectorのストレージレイヤーを提供します。エージェントは引き続き組み込みのメモリツールを使用します。プロバイダーはこれらの書き込みをミラーし、意味検索のために実質的な会話ターンを保存します。

明示的にテーマ横断検索が要求されない限り、メモリは現在のエージェントのテーマにスコープされます。メモリのホットパスではLLMを使わずに埋め込みを実行し、書き込みをキューに入れるため、エージェントのスレッドは埋め込みやデータベース操作を待ちません。

最低基準を課したテストカバレッジ

新しいテストは、ストレージ操作と競合、アイデンティティ分離、検索、コマンドライン保守、HTTPエラー、ライターシャットダウン、およびホスト統合境界での失敗をカバーしています。

測定結果は次のとおりです。

  • ライブスイートで789件のテストが成功し、スキップはゼロです。
  • 6つのランタイムモジュールすべてで**ステートメントカバレッジ100%**です。
  • ブランチカバレッジ99.66%、または**ステートメントとブランチを合わせたカバレッジ99.92%**です。
  • ライブCIでは、**合計カバレッジの最低基準99.5%**を強制しています。

2つのブランチ結果はまだレポート上に表示されています。1つは、反復0回のリトライループを必要としますが、実際には常に少なくとも1回試行します。もう1つは、生成された委任テキストが空またはノイズであることを必要としますが、実際には常に固定の委任プレフィックスを含みます。ランタイムコードを除外してパーセンテージを引き上げることはありませんでした。

カバレッジはテストが実行したパスを記録しますが、プログラムにバグがないことを証明するものではありません。テストには有用なアサーションと現実的な失敗ケースが必要です。スイートはPostgreSQL 16、17、18に対して実行され、Python 3.11、3.12、3.13のユニットテストと、固定された上流のコンプライアンスチェックもあわせて実行されます。

2つの失敗をプロバイダー内に収める

テストにより、例外がエージェントループに漏れる可能性がある2つの箇所が明らかになりました。1つは初期化中のデータベースストアの構築であり、もう1つはバックグラウンドライターを通じたメモリ書き込みのスケジュールです。

バージョン1.0.2では、両方を捕捉してログに記録します。ストアの構築に失敗するとプロバイダーは利用不可になり、キューへの追加に失敗すると書き込みフックが機能低下します。どちらの経路も、エージェントスレッドに同期的な埋め込みやデータベース処理を追加しません。

Ruffのルール、ローカルのコミットフック、保護されたメインブランチのチェック、およびバージョンと設定のチェックが、変更の出荷前に同じ期待値を強制するようになりました。

インストールするパッケージを追跡する

PyPIのwheelとソースアーカイブの両方に、Trusted Publishingを通じて作成された発行アテステーションが付与されています。GitHubも、両ファイルのビルドプロベナンスを記録しています。リリースワークフローは、アップロード前にアーカイブの内容とソースチェックアウトを比較します。

両方のPyPIアテステーションをリポジトリに対して検証し、PyPIのファイルとGitHubリリースアセットのハッシュが一致することを確認しました。

プロベナンスにより、読者はファイルの由来元を検証できます。これはコードレビューやテストを補完しますが、コードが正しいことを認定するものではありません。

1.0.2へのアップグレード

エージェントを実行しているPython環境内で、次を実行してください。

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

プロバイダーを読み込むHermesプロセスを再起動し、hermes memory statusを確認してください。1.0.1から1.0.2への新しいマイグレーションやスキーマ変更はありません。新規インストールまたは古いデプロイの場合は、リポジトリのインストールおよびアップグレード手順に従ってください。

このプロジェクトはBSD-3-Clauseのもとでオープンソースであり、著作権はGreen Yoga Incに帰属します。