osl CLI

Binarka osl napędza pętlę autorowania dla deweloperów i CI.

Komendy

Komenda	Cel
`osl validate <project_dir>`	JSON Schema + cross-reference’y + istnienie modeli dbt
`osl compile <project_dir> [--output target/]`	Wyemituj kanoniczny `manifest.json`
`osl plan <project_dir> <query>`	Dry-run zapytania — zbadaj plan SQL/retrievalu + sprawdzenie polityki
`osl publish <project_dir> --to <engine>`	Wgraj manifest (atomowo; `--revert`)
`osl migrate from-metricflow <src> <dst>`	Wygeneruj projekt OSL z projektu MetricFlow
`osl export to-metricflow <src> <dst>`	Wyeksportuj projekt OSL jako czysty MetricFlow
`osl test <project_dir>`	Testy golden SQL, chunk-schema, joint round-trip, leksykonu
`osl conformance test --level <level> <project_dir>`	Uruchom oficjalny zestaw conformance

Przykład

$ 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.

Klienci referencyjni Apache-2.0

Silnik referencyjny dostarcza dwie biblioteki klienckie (specyfikacja ich nie wymaga — działa każdy klient HTTP):

Python — pyosl (REST + MCP). Zalecany do jobów Dagstera, rozszerzeń dbt, skryptów.
TypeScript — osl-client (REST). Do aplikacji webowych i Node.js.