Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.

from @unified-product-graph/cli · Stand in the graph

upg check

One ranked verdict: structure + health + gaps + anti-patterns. Exit 2 on violations.

Usage

upg check [options]

Options

--file <path>
Path to .upg file
--json
Machine-readable JSON output
--ci
CI mode: JSON output, strict exit contract (exit 2 on any high finding)
--structure-only
Gate the exit code on structural validity alone; anti-patterns are reported but do not fail the run

Examples

Fold verify + health + gaps + anti-pattern lint into one ranked verdict

upg check

Output

⬡ Checkout Redesign · stage: build
  Health 82/100  ████████▌░      Structure ✓ valid

  Top fixes (ranked):
  1 ◑ Orphaned opportunity (medium)  "Reduce cart abandonment" has no solution
       → upg gaps --domain discovery

CI gate: JSON out, exit 2 on any high-severity finding

upg check --ci

Related

upg fixupg healthupg verifyupg gaps