Zum Inhalt springen

Modul I — Inventar & Discovery

Modul I ist der Katalog des Estate: ein passives, busgetriebenes Inventar von allem, was existiert — Agents, Sessions, Claude-Code-Instanzen, MCP-Server, Skills, Tools, Ressourcen, Modelle, Provider und nicht-menschliche Identitäten. Es betreibt Discovery durch Zuhören, nie durch Sondieren, und erfasst nur Beziehungen, Identifikatoren und Lebendigkeit — niemals Payloads. Diese Seite ist die Referenz dafür, was der Katalog enthält und was er bewusst nicht enthält.

Connectoren emittieren Beobachtungen, keine Entitäten. Sie veröffentlichen normalisierte edge.observed- und cost.sampled-Fakten auf dem Event-Bus; die Entitäten, die sie implizieren, werden nie gesendet. Modul I materialisiert die Kernentität, die jede Beobachtung anhand ihrer natürlichen Referenz benennt: eine Herkunft session/agent/identity, einen MCP-Server, ein Tool, eine Ressource, einen Skill und — aus Kostenproben — einen Provider und ein Modell (entdeckt, ohne Preisgestaltung; FinOps besitzt das). Die Materialisierung ist idempotent unter At-least-once-Zustellung: find-or-create auf dem natürlichen Schlüssel, sodass dieselbe zweimal gesehene Beobachtung nie eine Entität dupliziert.

Das Modul registriert eine eigene Entität, inventory.catalog_entry — ein Discovery-Overlay, das an jede materialisierte Kernentität angehängt wird. Es erfasst, wie etwas gefunden wurde, nicht, was es tat: eine Liste von Signalquellen, die Hosts, auf denen es gesehen wurde, First- und Last-seen-Zeitstempel, einen Vorkommenszähler und einen Lebendigkeits-status von active oder stale. Ein periodischer Staleness-Sweep markiert einen Eintrag als stale, wenn er nicht innerhalb des konfigurierten Fensters gesehen wurde, und setzt ihn in dem Moment auf active zurück, in dem er wieder auftaucht; der Sweep läuft nur über die Mandanten, die das Modul tatsächlich beobachtet hat (es kann Mandanten nicht aufzählen und tut dies auch nicht). Die Lese-Oberfläche ist klein und schreibgeschützt: eine summary-Zählung nach Art und Quelle, eine paginierte entities-Auflistung, filterbar nach Art und Status, und eine Detailansicht für eine einzelne Entität. Jeder Read erfordert eine mandantenbezogene, namespaced Leseberechtigung (die niedrigste Viewer-Stufe genügt); die Ingestion ist hochfrequent und wird nicht pro Write auditiert. Die vollständigen Formen liegen in der Event-Bus-Referenz und den typisierten Schnittstellen des Produkts.

Modul I ist ein reiner Consumer. Es abonniert edge.observed, cost.sampled und finding.reported und schreibt nur sein eigenes Katalog-Overlay sowie die Kernentitäten, die es ableitet. Es emittiert keine eigenen Events und exponiert keine Aktuierungsoberfläche — Discovery ist naturgemäß beobachten-und- katalogisieren. Die Referenzen, die es persistiert, kommen bereits bereinigt von den Connectoren an; das Modul speichert sie wortgetreu und fügt keine eigenen Rohdetails hinzu, sodass die Minimal-Data-Eigenschaft eine Eigenschaft der Leitung ist, durchgängig gewahrt.