Skip to content

from @unified-product-graph/cli · Read

upg health

Score the graph 0–100. Gate CI with --min-score.

Usage

upg health [options]

Options

--file <path>
Path to .upg file
--json
Machine-readable JSON output
--min-score <n>
Exit 1 if score is below this threshold
--format <fmt>
text | badge. Defaults to text
--watch
Live dashboard. Re-renders when the .upg file changes

Examples

Print the graph health score and breakdown

upg health

Output

  UPG · Health

  Score  82/100  ████████▌░
  Product   Checkout Redesign
  Nodes     42   Edges  73
  Orphans   3 (7%)
  Domains   6/16
  Validate  94%

  Domains
  ✓ discovery   opportunity, solution
  ✓ delivery    feature, release
  ✗ growth      (empty)

  Chains
  ✓ persona → job            5/5
  ✗ hypothesis → experiment  3/8

Fail CI if the graph drops below 70

upg health --min-score 70

Machine-readable badge output for a README shield

upg health --format badge --json

Related

upg verifyupg gapsupg diff