Context Surface Analyzer

Una utilidad local y determinista para medir una instantánea explícita del catálogo de herramientas de Agent y comparar dos instantáneas.

Informa sobre bytes UTF-8 canónicos y resúmenes SHA-256, recuentos de herramientas/esquemas, esquemas duplicados exactos, colisiones de nombres graves, comprobaciones de presupuesto declarado y deltas. Los recuentos de tokens opcionales se siguen midiendo externamente y están completamente etiquetados; el producto no infiere tokens a partir de los bytes ni decide si una herramienta es útil.

Ejecución

Requiere Node.js 22 o superior y no tiene dependencias de terceros en tiempo de ejecución.

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

La interfaz web se abre en http://127.0.0.1:4173. Use --port 0 para seleccionar un puerto efímero. Una instantánea se puede pegar o cargar desde un archivo JSON local acotado; el navegador no la retiene después de cerrar la página.

Related MCP server: repo-health

Autoridad de la instantánea

Adquiera cada instantánea del proveedor actual, del host o de un exportador autorizado. Este producto deliberadamente no descubre un host, no inicia servidores MCP arbitrarios, no rastrea archivos ni trata los fixtures del repositorio como el catálogo actual instalado. Proyecte el catálogo exportado al formato cerrado context-surface.snapshot.v0.1 antes del análisis y conserve el exportador, el proveedor y la revisión como fuente de registro.

MCP

Inicie el servidor JSON-RPC stdio delimitado por líneas:

npm run mcp

Expone dos herramientas de solo lectura:

• context.analyze: una instantánea a un análisis;

• context.diff: la instantánea anterior y la posterior a una comparación.

Ambas aceptan el JSON de la instantánea como cadenas acotadas, por lo que la ruta de Agent no tiene ninguna autoridad ambiental sobre el sistema de archivos. Consulte el modelo de producto para conocer el contrato de instantánea y la semántica exacta.

Este entorno de ejecución portátil sirve intencionalmente a la era heredada de MCP 2025 hasta la revisión 2025-11-25. Los clientes de doble era pueden identificar ese límite a partir de la respuesta de método no encontrado de server/discover y recurrir a initialize. Este plugin sin dependencias no declara el transporte moderno exclusivo de 2026.

Ajustes locales de Codex

Construya y valide el plugin local del repositorio, añada este repositorio como un marketplace local y, a continuación, instale el plugin:

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

Inicie una nueva tarea de Codex tras la instalación para que las herramientas de Skill y MCP se carguen desde la misma versión cacheada del plugin.

Estado

Este es un MVP local. Las comprobaciones de desarrollo, las sondas directas en tiempo de ejecución, el enrutamiento de Codex instalado, el comportamiento de producción bajo carga, la preparación para el lanzamiento público y la aceptación visual del propietario siguen siendo declaraciones independientes. Consulte el contrato de revisión y la primera nota de catálogo real dogfooding.

Licencia

Apache License 2.0. Consulte LICENSE y NOTICE.