Outputs

Generators and adapters

Only implemented targets from the reference CLI are listed here.

markdown

Generates: index.md, domains.md, entities.md, metrics.md

Readable project documentation.

semantics generate examples/supply-chain --target markdown --output dist/markdown

html

Generates: index.html

Standalone generated documentation.

semantics generate examples/supply-chain --target html --output dist/html

mermaid

Generates: semantic-graph.mmd

Entity relationship diagrams.

semantics generate examples/supply-chain --target mermaid --output dist/mermaid

dbt

Generates: semantic_models.yml

dbt Semantic Layer-oriented scaffolding.

semantics generate examples/supply-chain --target dbt --output dist/dbt

openmetadata

Generates: openmetadata.json

OpenMetadata-oriented import payloads.

semantics generate examples/supply-chain --target openmetadata --output dist/openmetadata

ai-context

Generates: ai-context.json, ai-context.md

AI and retrieval context files.

semantics generate examples/supply-chain --target ai-context --output dist/ai-context

knowledge-graph

Generates: knowledge-graph.jsonld, knowledge-graph.ttl

Graph-ready semantic relationships.

semantics generate examples/supply-chain --target knowledge-graph --output dist/knowledge-graph

databricks

Generates: databricks_metric_views.yml

Databricks metric view scaffolding.

semantics generate examples/supply-chain --target databricks --output dist/databricks

snowflake

Generates: snowflake_semantic_model.yml

Snowflake semantic model scaffolding.

semantics generate examples/supply-chain --target snowflake --output dist/snowflake

fabric

Generates: fabric_semantic_model.yml

Microsoft Fabric semantic model scaffolding.

semantics generate examples/supply-chain --target fabric --output dist/fabric

bigquery

Generates: bigquery_dataform_semantics.yml

BigQuery/Dataform semantic scaffolding.

semantics generate examples/supply-chain --target bigquery --output dist/bigquery

openmetadata-adapter

Generates: openmetadata.json

Vendor adapter output for OpenMetadata.

semantics generate examples/supply-chain --target openmetadata-adapter --output dist/openmetadata-adapter

apache-metadata

Generates: apache_metadata_mappings.yml

Apache Iceberg, Polaris, and Gravitino mappings.

semantics generate examples/supply-chain --target apache-metadata --output dist/apache-metadata

Deploying

Generate writes files. Deploy publishes them.

These are separate steps. semantics generate above only ever writes local artifact files — it never talks to a real platform. semantics deploy takes those files and publishes them, after checking the target environment's governance gates (approval, validation/lint status, a rollback plan) declared in a project's semantic-project.yaml.

The only deploy adapter shipped today is git: it commits generated artifacts into a target repository/branch, optionally pushing with a credential read from an environment variable. Cloud-platform adapters (Databricks, Snowflake, Fabric, BigQuery) currently implement generate only.

semantics deploy starter-kits/enterprise --environment dev --artifacts dist/databricks --repo ../deploy-target
semantics rollback <reference> --repo ../deploy-target