CLI osl

El binario osl dirige el loop de autoría para desarrolladores y CI.

Próximamente

El CLI osl es una épica próxima (platform/cells/osl-cli/). La superficie de comandos de abajo es el contrato comprometido; la referencia ganará tablas completas de flags y semántica de exit-codes a medida que aterrice.

Comandos

Comando	Propósito
osl validate <project_dir>	JSON Schema + cross-references + existencia de modelos dbt
osl compile <project_dir> [--output target/]	Emitir el manifest.json canónico
osl plan <project_dir> <query>	Dry-run de una query — inspecciona plan de SQL/retrieval + chequeo de política
osl publish <project_dir> --to <engine>	Subir el manifest (atómico; --revert)
osl migrate from-metricflow <src> <dst>	Generar un proyecto OSL desde un proyecto MetricFlow
osl export to-metricflow <src> <dst>	Exportar un proyecto OSL como MetricFlow puro
osl test <project_dir>	Tests de golden SQL, chunk-schema, round-trip de joints, lexicon
osl conformance test --level <level> <project_dir>	Correr la suite oficial de conformidad

Ejemplo

$ osl validate ./caixabank-cartera-eu/
✔ project.yml                                      valid
✔ models/customers.yml                             valid (3 models, 12 dimensions, 4 measures)
✔ metrics/arr.yml                                  valid
✗ facets/meeting_transcripts.yml                   2 errors
   E0201 chunk_schema missing required field 'embedding'  at line 12
   E0204 embedding.provider == tenant-byo requires .adapter  at line 18
✔ joints/customer.yml                              valid

Summary: 5 files valid, 1 file with errors. Exit code: 1.

Clientes de referencia Apache-2.0

El motor de referencia incluye dos librerías cliente (la spec no las requiere — cualquier cliente HTTP funciona):

• Python — pyosl (REST + MCP). Recomendado para jobs de Dagster, extensiones de dbt, scripts.
• TypeScript — osl-client (REST). Para apps web y Node.js.