Context Surface Analyzer

Ein lokales, deterministisches Werkzeug zum Messen eines expliziten Agent-Toolkatalog-Snapshots und zum Vergleich zweier Snapshots.

Es meldet kanonische UTF-8-Bytes und SHA-256-Prüfsummen, Tool-/Schema-Anzahlen, exakte Duplikat-Schemas, harte Namenskollision, deklarerte Budgetprüfungen und Deltas. Optionale Tokenanzahlen bleib egen gemessen und vollständig gekennzeichnet; das Produkkt leitet keine Token aus Bytes ab und entscheidet nicht, ob ein Tool nützlich ist.

Ausführen

Erfordert Node.js 22 oder neuer und hat keinerlei Drittanbieter-Laufzeitabhängigkeiten.

npm run check
node src/cli.js analyze examples/baseline.json
node src/cli.js diff examples/baseline.json examples/updated.json
npm start

Die Weboberfläche öffnet sich unter http://127.0.0.1:4173. Verwenden Sie --port 0, um einen kurzlebigen Port zu wählen. Ein Snapshot kann eingefügt oder aus einer begrenzten lokalen JSON-Datei geladen werden; der Browser behält ihn nicht, nachdem die Seite geschlossen wurde.

Related MCP server: repo-health

Snapshot-Quelle

Beziehen Sie jeden Snapshot vom aktuellen Anbieter, Host oder einem autorisierten Exporteur. Dieses Produkt entdeckt bewusst keinen Host, startet keine beliebigen MCP-Server, durchsucht keine Dateien und behandelt Repository-Fixtures nicht als den aktuell installierten Katalog. Überführen Sie den exportierten Katalog in das geschlossene Format context-surface.snapshot.v0.1 und behalten Sie den Exporteur, den Anbieter und die Revision als maßgebliche Quelle bei.

MCP

Starten Sie den zeilengetrennten JSON-RPC-stdio-Server:

npm run mcp

Er stellt zwei schreibgeschützte Tools bereit:

• context.analyze: ein Snapshot zu einer Analyse;

• context.diff: frühere und spätere Snapshots zu einem Vergleich.

Beide akzeptieren Snapshot-JSON als Strings begrenzter Länge, sodass die Agentenroute keinerlei umgebungsbedingte Dateisystem-Berechtigung besitzt. Siehe das Produktmodell für den Snapshot-Vertrag und die genaue Semantik.

Diese portable Laufzeitumgebung bedient die MCP-2025-Legacy-Ära bewusst bis einschließlich der Revision 2025-11-25. Clients, die beide Ära unterstützen, erkennen diese Grenze an der method-not-found-Antwort auf server/discover und fallen auf initialize zurück. Ein reiner 2026-Transport wird von diesem abhängigkeitsfreien Plugin nicht beansprucht.

Lokaler Codex-Plugin

Erstellen und validieren Sie das repository-lokale Plugin, fügen Sie dieses Repository als lokalen Marketplace hinzu und installieren Sie dann das Plugin:

npm run check
codex plugin marketplace add <repository-root>
codex plugin add context-surface-analyzer@context-surface-analyzer

Starten Sie nach der Installation eine neue Codex-Aufgabe, damit die Skill- und MCP-Tools aus derselben zwischengespeicherten Plugin-Version geladen werden.

Status

Dieses ist ein lokales MVP. Entwicklungschecks, direkte Laufzeitproben, installiertes Codex-Routing, Verhalten unter Produktionslast, öffentliche Freigabereife und visuelle Abnahme durch den CEuGenthümer bleiben getternte Ansprüche. Siehe den Review-Vertrag und die erste Notiz zum realen Katalog-Dogfooding.

Lizenz

Apache-Lizenz 2.0. Siehe LICENSE und NOTICE.