Puerta de Decisión CLI

La CLI de Decision Gate es la interfaz de comandos orientada al usuario para la operación del servidor MCP, herramientas del cliente MCP, flujos de trabajo de runpack, utilidades de autoría y ayudantes de registro/documentación. Es parte del repositorio OSS de Decision Gate y se envía junto con los crates principales.

Lo que cubre

Ejecutando el servidor MCP con una configuración local.
Validando la configuración, los insumos de autoría y los artefactos de runpack.
Acceso de cliente MCP a herramientas y recursos a través de HTTP, SSE o stdio.
Flujos de trabajo de descubrimiento de proveedores y registro de esquemas.
Búsqueda de documentación y lectura de recursos a través de MCP.
Evaluación de interoperabilidad para comprobaciones de herramientas de extremo a extremo.
Envolturas para la generación/verificación de contratos y SDK.

Forma actual (a partir del 1 de febrero de 2026)

Los nombres y grupos de comandos son estables y cubren toda la superficie de la herramienta MCP, además de los envoltorios de contrato y SDK. Utilice decision-gate --help para ver las banderas autorizadas y específicas de la versión.

Flujos de trabajo de inicio rápido

Servir con una configuración preestablecida

decision-gate serve --config configs/presets/default-recommended.toml

Para el desarrollo local sin un binario preconstruido:

cargo run -p decision-gate-cli -- serve --config configs/presets/default-recommended.toml

Validar o normalizar la entrada de autoría

decision-gate authoring validate --input examples/scenario.ron --format ron

decision-gate authoring normalize --input examples/scenario.ron --format ron \
  --output examples/scenario.json

Exportación y verificación de Runpack

decision-gate runpack export --help
decision-gate runpack verify --help

Inspeccionar herramientas y documentos de MCP

decision-gate mcp tools list --transport http --endpoint http://127.0.0.1:8080/rpc
decision-gate docs search --transport http --endpoint http://127.0.0.1:8080/rpc --query "runpack"

Superficie de comando (resumen)

Área	Comando	Propósito
Servidor	`serve`	Ejecutar el servidor MCP de Decision Gate a partir de una configuración.
Configuración	`config validate`	Validar decision-gate.toml y salir con estado.
Autorización	`authoring validate`	Validar la entrada de ScenarioSpec (RON/JSON).
Autorización	`authoring normalize`	Normalizar a JSON canónico (RFC 8785).
Paquetes de ejecución	`runpack export`	Exportar un paquete de ejecución para uso fuera de línea.
Paquetes de ejecución	`runpack verify`	Verificar la integridad del paquete de ejecución fuera de línea.
Proveedores	`provider list`	Listar proveedores y verificaciones configurados.
Proveedores	`provider contract get`	Obtener el JSON del contrato del proveedor.
Proveedores	`provider check-schema get`	Obtener los metadatos del esquema de verificación del proveedor.
Esquemas	`schema register`	Registrar un registro de esquema.
Esquemas	`schema list`	Listar esquemas para un inquilino/espacio de nombres.
Esquemas	`schema get`	Obtener esquema por id/version.
Documentos	`docs search`	Buscar secciones de documentación.
Documentos	`docs list`	Listar recursos de documentación.
Documentos	`docs read`	Leer un recurso de documentación URI.
Interoperabilidad	`interop eval`	Evaluar una ejecución de interoperabilidad contra un servidor MCP.
Herramientas MCP	`mcp tools list`	Listar definiciones de herramientas MCP.
Herramientas MCP	`mcp tools call`	Llamar a una herramienta MCP por nombre.
Recursos MCP	`mcp resources list`	Listar recursos MCP.
Recursos MCP	`mcp resources read`	Leer un recurso MCP por URI.
Herramientas tipadas MCP	`mcp tool <tool>`	Envoltura tipada para cada herramienta MCP.
Contrato	`contract generate`	Generar artefactos de contrato.
Contrato	`contract check`	Verificar artefactos de contrato.
SDK	`sdk generate`	Generar artefactos SDK/OpenAPI.
SDK	`sdk check`	Verificar artefactos SDK/OpenAPI.

Opciones del cliente MCP

--transport http|sse|stdio selecciona el transporte MCP.
--endpoint establece la URL HTTP/SSE; --stdio-command más args/env configura stdio.
--bearer-token, --client-subject, --auth-profile y --auth-config controlan la autenticación.
--json o --input suministra cargas útiles de la herramienta; --no-validate omite las comprobaciones de esquema.

Envoltorios de herramientas MCP tipadas

Utilice decision-gate mcp tool <name> para envolturas tipadas en toda la superficie de la herramienta:

Scenario lifecycle: scenario-define, scenario-start, scenario-status, scenario-next, Ciclo de vida del escenario: scenario-define, scenario-start, scenario-status, scenario-next, scenario-submit, scenario-trigger, scenarios-list
Evidencia y runpacks: evidence-query, runpack-export, runpack-verify, precheck
Providers and schemas: providers-list, provider-contract-get, provider-check-schema-get, Proveedores y esquemas: providers-list, provider-contract-get, provider-check-schema-get, schemas-register, schemas-list, schemas-get
Docs: decision-gate-docs-search

Selección de idioma

Los catálogos actuales de la CLI se envían para EN (inglés) y CA (catalán), con idiomas adicionales planeados. Utilice --lang en|ca o configure DECISION_GATE_LANG. La salida en idiomas distintos del inglés incluye un aviso de traducción automática.

Modelo de seguridad y límites

Las entradas son validadas y fallan de manera controlada en caso de errores.
Las lecturas de archivos y las cargas útiles de MCP están limitadas en tamaño para evitar el agotamiento de cargas útiles no confiables.
Las entradas de la herramienta MCP están validadas por esquema de forma predeterminada (utilice --no-validate solo cuando sea necesario).
Las vinculaciones HTTP/SSE que no son de bucle inverso requieren una aceptación explícita en la CLI, además de TLS y autenticación no local.
Las salidas legibles por máquina se configuran por defecto en JSON canónico; los comandos seleccionados ofrecen formatos de texto/markdown.