Referencia del CLI PliegoRS | new, check, build, dev e inspect

Superficie de comandos

pliego new <path>

Crea el starter predeterminado de forma transaccional

pliego templates

Lista IDs y capacidades de starters mantenidos

pliego doctor

Diagnostica prerrequisitos globales o del proyecto con verificaciones accionables

pliego report --bundle

Crea un bundle local redactado de soporte sin subirlo

pliego upgrade --check

Evalúa un plan explícito de upgrade sin modificar el proyecto

pliego telemetry <status|enable|preview|export|disable>

Controla el journal local de telemetría desactivado por defecto

pliego check

Valida contratos del proyecto y toolchain

pliego build

Produce y verifica salida de producción

pliego cache status

Verifica y explica el resultado del último build de producción

pliego cache clean

Elimina registros privados preservando Cargo y la salida publicada

pliego dev

Compila, observa, diagnostica y recarga

pliego preview

Sirve un build verificado existente

pliego inspect

Reporta rutas, archivos, bytes y validez del ledger

pliego why artifact <path|route>

Verifica y explica la cadena causal source-to-artifact

pliego why-rebuilt

Explica el último rebuild limitado de desarrollo

pliego version

Imprime la versión del CLI

Servidores de desarrollo

shell

pliego dev
pliego dev 4300
pliego dev 4300 --lan
pliego preview 4400 --host 127.0.0.1

dev recompila e inyecta un hook EventSource limitado que nunca entra en la salida de producción. preview sirve únicamente un build ya verificado. Ambos se enlazan a loopback salvo que --lan o --host sean explícitos.

Diagnósticos legibles por máquinas

shell

pliego build --diagnostic-format json

json

{
  "code": "PLG-BLD-001",
  "exit_code": 5,
  "category": "build",
  "message": "…",
  "help": "Correct the compiler error and run pliego build again."
}

Los diagnósticos humanos y JSON contienen el mismo código estable, categoría, mensaje, acción de recuperación y estado de salida.

Códigos de salida

2 / PLG-ARG: Comando u opción inválida
3 / PLG-PRJ, PLG-NEW: Fallo de descubrimiento del proyecto o scaffold
4 / PLG-ENV: Fallo del toolchain o contrato de paquetes
5 / PLG-BLD: Fallo de compilación o build del sitio
6 / PLG-ART: Fallo de verificación del artefacto o ledger
7 / PLG-SRV: Fallo del servidor de desarrollo o preview