Validate and compile an OWX source locally

Run the complete gate

Use fmt --check in automation. Compile is transactional: a failed compile must not replace the last valid JSON artifact.

ow a2ui check ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx --check
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.json

Use preflight for required evidence shapes

Preflight can enforce the native components a work promises. Set requirements from the content contract, not from a generic template.

ow a2ui preflight ./artifact/document.owx --require ow-chart:line=1 --require ow-table=1 --min-desktop-heights 2

Repair the named boundary

1. Syntax or unknown tag: change the OWX source.
2. Missing binding: repair the Dataset, Query, or Fact reference.
3. Missing asset: restore a package-local file and its provenance.
4. Quick-style failure: complete the required tokens and consume every required utility group.

Inspect the real render once

A successful compile proves the typed contract, not the pixels. Open the complete output in a real browser and check overflow, clipping, empty charts, mobile reading order, and unresolved visible values.