novafabric

NovaFabricは、AIおよびHPCの実行を再現可能、比較可能、かつ監査可能にするためのセルフホスト型コマンドラインツールです。その価値の単位は「カプセル」であり、ホストされたデータベースのトレース行ではなく、~/.novafabric/capsules/ 配下に書き込まれるULID名のディレクトリとして、1回の実行に関する観測可能な事実を保持します。インストールは `pip install novafabric` (Python 3.12+) で行い、オプションのextrasを追加することでダッシュボード、クエリ、サーバー、コンプライアンス、およびSigstoreのサポートが提供されます。`nova doctor --check-extras` で不足している機能を確認できます。 キャプチャ機能：`nova capture python my_agent.py --dataset data.csv` はあらゆるコマンドで動作し、アプリケーションの変更を必要としません。PYTHONPATHを通じて sitecustomize.py ローダーを注入し、OpenAI、Anthropic、MCP SDKへのモンキーパッチに加え、httpx、requests、aiohttp、urllib3へのワイヤレベルのフックをインストールします。また、レイヤリングガードにより、ネストされた呼び出しでも単一のレコードとして出力されます。OpenTelemetry GenAIのセマンティックコンベンションフィールド（temperature、top_p、max_tokens、seed、終了理由など）が抽出されます。Claude Code、Cursor、Node/Goエージェントなどの非Pythonクライアントに対しては、`nova api-proxy` と `nova mcp-proxy` という2つの透過プロキシが、クライアントに触れることなくLLMおよびMCPトラフィックをキャプチャします。カプセルは成功時と失敗時の両方で書き込まれるため、クラッシュした際もステータス、終了コード、エラーブロックを含む証拠として記録されます。 カプセルの内容：capsule.yamlマニフェスト、trace.jsonlスパン、model-calls.jsonl、tool-calls.jsonl、env.lock、replay.yaml、入出力（stdout/stderr）、およびredaction-proof.jsonが含まれます。最終確定前にすべてのアーティファクトに対してシークレットスキャンが実行されます。redaction proof（秘匿化証明）のないカプセルは `nova validate` で無効とされ、エクスポートできません。 リプレイと差分：`nova replay` は4つのモードを提供します。forensic（読み取り専用の検査、ネットワークやサブプロセスなし）、mocked（カプセルキャッシュからモデルとツール呼び出しを提供してコマンドを再実行）、semantic（トークンではなく意味を判定し、0.0〜1.0の類似度を算出）、およびexact（決定論的な環境と呼び出しごとのシードを必要とするバイト単位の完全一致）です。READMEでは、リモートLLM呼び出しの完全な再現は保証していないことが明記されています。`nova diff` は2つの実行結果を比較し、`nova diff --assert-no-regressions` は動作変更があった場合に非ゼロで終了します。これは、「昨日は動作していたが今日は失敗する」エージェントのためのCIゲートとして位置付けられています。 ガバナンスとリネージ：ローカルのSQLite Asset Registryに、7つのタイプ（model, agent, prompt, tool, dataset, evaluation, deployment）のバージョン管理されたアセットを保存します。これらは name@version としてアドレス指定され、開発からアーカイブまでのライフサイクルを持ちます。昇格（promotion）はガバナンスメタデータのみであり、何もデプロイしません。リネージレイヤーは、観測された信頼度または推論された信頼度を伴う mechanical な consumed、produced_by、replayed_from エッジを生成し、プロバナンス、影響範囲（blast-radius）、リプレイチェーンのクエリをサポートします。また、OpenLineageイベントの出力およびW3C PROV-Nエクスポートが可能です。大規模なグラフ向けに実験的なオプションバックエンドが存在します。`nova export-evidence` は、カプセル、リネージ部分グラフ、in-toto DSSEアテステーション、およびed25519署名を含む署名付きZIPを構築します。これはNovaFabricランタイムなしで、sha256sumとed25519検証ツールを用いて検証可能です。 適合性：本プロジェクトは、オーケストレーター、モデルトレーナー、推論サーバー、ベクトルDB、LLMゲートウェイ、またはCIランナーではないとしています。リアルタイムダッシュボード、アラート、マルチユーザー分析が目的である場合は、マネージドSaaSのオブザーバビリティプラットフォームの方が手間が少ないとしています。サーバーモードとライブダッシュボードは実験的であり、カプセルは計画されているv1.0のスキーマ凍結まで固定されません。また、本ツールはコンプライアンスワークフローを認定するものではなく、それをサポートする証拠を生成するものです。READMEに記載されている想定ユーザーには、ML/プラットフォームエンジニア、HPCおよび研究チーム、コンプライアンス担当者、インシデントレスポンダー、およびエージェントフレームワークの作者が含まれます。