モジュール I — インベントリと発見

モジュール I は、エステートにおける観測済みエンティティのカタログである。コネクターが実際に名前を挙げたエージェント、セッション、Claude Code インスタンス、MCP サーバー、スキル、ツール、リソース、モデル、プロバイダー、非人間 ID の、受動的でバス駆動のインベントリである。プローブによってではなく リッスンすることで発見する。ペイロードではなく関係性、識別子、生存性を記録し、存在するあらゆるもののセンサスではない。本ページは、カタログが保持するもの、観測来歴と耐久的鮮度の動き、そして本モジュールが意図的に主張しないものについてのリファレンスである。

観測来歴と耐久的鮮度は 26.10 に含まれる。

何を具現化するか

コネクターはエンティティではなく観測を発行する。コネクターは正規化された edge.observed と cost.sampled のファクトをイベントバスへ publish するが、それらが含意するエンティティそのものが送信されることは決してない。モジュール I は、各観測が指し示すコアエンティティを、その自然な参照から具現化する。すなわち、起点となる session/agent/identity、MCP サーバー、ツール、リソース、スキル、そしてコストサンプルからプロバイダーとモデル(価格情報なしで発見される。価格情報は FinOps が所有する)である。インベントリが購読するのはこれら 2 種類のイベントであり、ライブの finding はモジュール IIに属する。

自然キーに対するコアエンティティの find-or-create は、現行の単一ライターモデルにおける at-least-once 配信下でカタログエイリアスが重複するのを避ける。2 つのソースは、そのエイリアスを共有しつつも別々の観測を保持できる。共有は物理的に同一であることの証明にはならず、オーナー、ワークスペース、grant を移譲もしない。同じペイロードでも新しいイベント ID は新しいレシートである。それが別の活動かどうかは不明のままである。カタログの occurrence_count は、同じイベント ID のリプレイを含む配信回数であり、一意の活動数ではない。

観測の来歴

カタログエイリアスに加えて、本モジュールは観測がどのように到着したかの、テナントスコープの加法的な投影を保存する。すなわち、イベント ID をキーとするレシート、具現化されたエンティティごとのメンバー行(ネイティブ参照、および登録スナップショットが有効なときは安定した観測アイデンティティ)、そして同じイベント ID が後から異なる投影事実を運んできたときの競合行である。元のレシートは保持され、競合は上書きではなく記録される。欠落したイベント ID は保存用のアイデンティティだけを得て、ペイロードでは決して重複排除されない。同じ ID と同じ事実のリプレイは、エイリアスを再解決せずにカタログのレガシー配信カウンタを更新する。コンソールは既存のテナント広域権限 inventory:catalog:read で GET /v1/m/inventory/entities/{kind}/{id}/observations により、カタログ上の 1 エンティティについて保存済みレシートを一覧できる。項目は相異なるレシートごと、レシート ID の昇順、1 ページ最大 25 件である。各項目は受信時に記録された登録の歴史的スナップショット(ソースの現在の登録や健全性ではない)、宣言があればソースが宣言した発生時刻、保持された事実の最初と最後の受信、一致する事実の配信、衝突する再配信が保持されているかどうかである。空のページは、そのエンティティが観測されたことがない証明にはならない。has_more、空の一覧、カタログ合計は網羅ではない。エンティティシートのカタログ鮮度は、成功した現行のポイントリードから来る。履歴とは別の読み取りである。ソース/ファミリ単位の網羅と C4 参照エステートは未完了のままである。

コントラクトとエンティティ

本モジュールは inventory.catalog_entry を登録する。具現化された各コアエンティティに付随する発見オーバーレイである。それが記録するのは どのように見つかったかであり、何をしたかではない。すなわち、シグナルソース、既知のホスト、初回観測・最終観測のタイムスタンプ、ソースが宣言した任意の occurred_at(宣言がなければ省略。このプラットフォームが見た時刻である last_seen とは別)、発生回数、そして active または stale という生存性 status である。読み取りサーフェスは小さく読み取り専用である。すなわち、種別とソース別の件数を示す summary、種別とステータスでフィルタ可能なページネーション付きの entities 一覧、単一エンティティの詳細ビュー、および上記のエンティティごとの観測履歴である。すべての読み取りはテナントスコープの名前空間付き読み取りパーミッションを必要とする(最下位の閲覧者ティアで十分)。カタログと来歴の書き込みは高頻度であり、書き込みごとに監査されることはない。

耐久的鮮度は第二のオーバーレイ inventory.freshness_sweep を保持する。テナントあたり高々 1 行が遅延作成され、開いているサイクルのカットオフ、不透明なカタログカーソル、サイクルが終端した最後のカットオフを持つ。その最後のカットオフは終了したスイープを記録するのであり、いずれかのソースが完全に列挙されたことを意味しない。完全な形状はイベントバスリファレンスおよび本製品の型付きインターフェイスに存在する。

耐久的鮮度

定期スイープは、このプラットフォームがサイクルのカットオフ以降に見ていないカタログエントリを stale とマークし、再出現した瞬間に active へ戻す。既定のしきい値は無音 30 分と 5 分間隔である。これはモジュールの既定値であり、現行バイナリにおけるオペレーター向け YAML 面ではない(コンポジションルートは空のホスト設定でモジュールを登録する)。

本モジュールはテナントを列挙せず、このプロセスがたまたま観測したテナントへ フォールバックもしない。非公開のコンポジションアダプターが耐久的な組織ディレクトリを読み、候補だけを返す。すなわち、このインスタンスのレジデンシーが扱うアクティブなビジネステナントであり、システムパーティション、停止中の org、このインスタンスが扱わないリージョンにピン留めされたテナントは含まれない。各ターンは通常のテナントスコープのストア書き込みを開くため、レジデンシー、サービス撤回、リーダーシップはそこで再検査される。スナップショットとターンの間に状態が変わったテナントはそこで拒否される。

権威あるディレクトリがなければ、スイープは明示的に失敗し、何も変更しない。 PostgreSQL では、その権威にはクロステナントのディレクトリ読み取りに既に使われている専用の NOSUPERUSER BYPASSRLS 管理読み取りプール(--admin-dsn)が必要である。その証明済みプールがなければ、スイープはアプリケーションロールが見える行を完全なディレクトリとしては扱わない。SQLite に同等のプール要件はない。データハンドルが配線されていれば新しい観測は引き続き永続化される。実行できないスイープが取り込みの購読を解除することはない。

各パスは候補ごとに1 ターンを与える。各ターンはカットオフより古いアクティブなエントリを最大 1,000 件の 1 ページだけ分類し、カーソルを保存するため、再起動は新しいイベントなしで続行できる。列挙と各テナントターンは 別々の時間予算を持つため、遅いテナントがパスの残りを消費することはない。局所的な失敗は、生きているプロセス内で後続テナントがターンを得ることを妨げない。テナント横断の再起動カーソルはなく、繰り返される再起動の下での公平性も、高可用性の主張もない。

ターンが正常に完了しなければ、そのページはマーク済みとしては数えられない。ページと進捗は一体のままである。次のターンは最後に保存されたもの — 以前の境界、あるいは既に進んだ境界 — を再読し、そこから続ける。本製品はメモリから進捗を再構成しない。

何を消費し何を生成するか

モジュール I はコンシューマーである。edge.observed と cost.sampled をサブスクライブし、自身のカタログオーバーレイ、導出するコアエンティティ、および上記の加法的な来歴・鮮度の行を書き込む。自身のイベントは一切発行せず、アクチュエーションサーフェスも公開しない。永続化する参照と選択された観測事実は、受け取ったとおりに保存される。本モジュールはそれらの値をさらにサニタイズしない。データの最小化はプロデューサー側の責務であり、観測を公開する前に行う必要がある。本モジュールはすべてのプロデューサーについてそれを証明できない。プロデューサーが公開していれば、永続化された参照にクエリ文字列、資格情報、その他の機微データが残ることがある。インベントリは活動の完全な生コンテンツを独自に収集せず、自身の生のペイロード、シークレット、プロンプト、コマンド、SQL は付加しない。

インベントリはアクセスグラフを所有しない。 決定 A(2026-06-03)の時点で、モジュール III(アクセスマップ)が read/write の AccessEdge の唯一の書き手 であり、トポロジーおよび Permitted-vs-Observed 差分の唯一の所有者である。インベントリはエッジが指し示すエンティティを発見しカタログ化するが、エッジ自体はもはや記録せず、トポロジールートも提供しない。グラフはモジュール III が起動時に配線されている場合にのみポピュレートされる。
発見はシグナルの分しか完全になりえない。 あるエンティティは、いずれかのコネクターがそれを観測した場合にのみカタログに存在する。カタログに存在しないことはエステートに存在しないことの証明にはならない。鮮度スイープの完了は、ソースの網羅、発見の完全性、正式な健全性、エンティティが除去されたことの証明のいずれでもない。
生存性は陳腐化であり健全性ではない。 stale は、このプラットフォームがカットオフ以降そのエンティティを観測していないことだけを意味する。再出現は active に戻す。セッションの沈黙は正常であり、正式な健全性/SLA はモジュール XXII に属する。スイープがコアエンティティ自身のライフサイクルを変更することは決してない。
捏造された詳細はない。 本モジュールは識別子、関係性、生存性カウンターを保存する。独自に収集した活動の完全な生コンテンツは保存せず、自身のペイロード、シークレット、プロンプト、コマンド、SQL も付加しない。受信したリソース URI は参照として保存されうる。インベントリはそれらの値を再サニタイズせず、クエリ文字列、資格情報、PII が含まれないことを証明できない。