Decision Gate CLI
La interfície de línia de comandes de Decision Gate és la superfície de comandes orientada a l’usuari per a l’operació del servidor MCP, les eines del client MCP, els fluxos de treball de runpack, les utilitats d’autoria i els helpers de registre/documentació. Forma part del repositori OSS de Decision Gate i s’envia juntament amb els crates bàsics.
Què cobreix
- Executant el servidor MCP amb una configuració local.
- Validant la configuració, els inputs d’autoria i els artefactes de runpack.
- Accés del client MCP a eines i recursos a través de HTTP, SSE o stdio.
- Fluxos de descoberta de proveïdors i registre d’esquemes.
- Cerca de documentació i lectura de recursos a través de MCP.
- Avaluació d’interoperabilitat per a comprovacions d’eines de principi a fi.
- Envoltoris per a la generació/verificació de contractes i SDK.
Forma actual (a partir de l’1 de febrer de 2026)
Els noms i grups de comandes són estables i cobreixen tota la superfície de l’eina MCP, així com els wrappers de contracte i SDK. Utilitzeu decision-gate --help per veure les banderes autoritzades i específiques de la versió.
Fluxos de treball ràpids
Serveix amb una configuració preestablerta
decision-gate serve --config configs/presets/default-recommended.toml
Per al desenvolupament local sense un binari preconstruït:
cargo run -p decision-gate-cli -- serve --config configs/presets/default-recommended.toml
Valida o normalitza l’entrada d’autoria
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ó i verificació de Runpack
decision-gate runpack export --help
decision-gate runpack verify --help
Inspeccionar eines i documents 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"
Superfície de comanda (resum)
| Àrea | Comandament | Propòsit |
|---|---|---|
| Servidor | serve | Executar el servidor Decision Gate MCP a partir d’una configuració. |
| Configuració | config validate | Validar decision-gate.toml i sortir amb estat. |
| Autoria | authoring validate | Validar l’entrada ScenarioSpec (RON/JSON). |
| Autoria | authoring normalize | Normalitzar a JSON canònic (RFC 8785). |
| Runpacks | runpack export | Exportar un runpack per a ús offline. |
| Runpacks | runpack verify | Verificar la integritat del runpack offline. |
| Proveïdors | provider list | Llistar proveïdors configurats i comprovacions. |
| Proveïdors | provider contract get | Obtenir el JSON del contracte del proveïdor. |
| Proveïdors | provider check-schema get | Obtenir metadades del esquema de comprovació del proveïdor. |
| Esquemes | schema register | Registrar un registre d’esquema. |
| Esquemes | schema list | Llistar esquemes per a un llogater/espai de noms. |
| Esquemes | schema get | Obtenir l’esquema per id/version. |
| Docs | docs search | Cercar seccions de documentació. |
| Docs | docs list | Llistar recursos de documentació. |
| Docs | docs read | Llegir un URI de recurs de documentació. |
| Interoperabilitat | interop eval | Avaluar una execució d’interoperabilitat contra un servidor MCP. |
| Eines MCP | mcp tools list | Llistar definicions d’eines MCP. |
| Eines MCP | mcp tools call | Cridar una eina MCP pel nom. |
| Recursos MCP | mcp resources list | Llistar recursos MCP. |
| Recursos MCP | mcp resources read | Llegir un recurs MCP per URI. |
| Eines tipades MCP | mcp tool <tool> | Wrapper tipat per a cada eina MCP. |
| Contracte | contract generate | Generar artefactes de contracte. |
| Contracte | contract check | Verificar artefactes de contracte. |
| SDK | sdk generate | Generar artefactes SDK/OpenAPI. |
| SDK | sdk check | Verificar artefactes SDK/OpenAPI. |
Opcions del client MCP
--transport http|sse|stdioselecciona el transport MCP.--endpointestableix l’URL HTTP/SSE;--stdio-commandmés args/configuració d’entorn configura stdio.--bearer-token,--client-subject,--auth-profilei--auth-configcontrolen l’autenticació.--jsono--inputsubministra càrregues d’eina;--no-validateomet les comprovacions d’esquema.
Envoltants d’eines MCP tipades
Utilitzeu decision-gate mcp tool <name> per a wrappers tipificats a tota la superfície de l’eina:
- Scenario lifecycle:
scenario-define,scenario-start,scenario-status,scenario-next, Cicle de vida de l’escenari:scenario-define,scenario-start,scenario-status,scenario-next,scenario-submit,scenario-trigger,scenarios-list - Evidència i runpacks:
evidence-query,runpack-export,runpack-verify,precheck - Providers and schemas:
providers-list,provider-contract-get,provider-check-schema-get, Proveïdors i esquemes:providers-list,provider-contract-get,provider-check-schema-get,schemas-register,schemas-list,schemas-get - Docs:
decision-gate-docs-search
Selecció de llengua
Els catàlegs actuals de la CLI s’envien per a EN (anglès) i CA (català), amb idiomes addicionals planificats. Utilitzeu --lang en|ca o configureu DECISION_GATE_LANG. La sortida no anglesa emet un avís de traducció automàtica.
Model de seguretat i barres de protecció
- Les entrades es validen i fallen tancades en cas d’errors.
- Les lectures de fitxers i les càrregues de MCP estan limitades en mida per evitar l’esgotament de càrregues no confiables.
- Les entrades de l’eina MCP es validen per esquema per defecte (utilitzeu
--no-validatenomés quan sigui necessari). - Les vinculacions HTTP/SSE no de retroalimentació requereixen una opció explícita a la línia de comandes, així com TLS i autenticació no local.
- Les sortides llegibles per màquina per defecte són en JSON canònic; els comandos seleccionats ofereixen formats de text/markdown.