Skip to main content

ovecc summary

One-screen health: structural counts, circular dependencies, boundary violations, coupling density, module hotspots, and a composite risk score.

Usage: ovecc summary [OPTIONS]

Example​

$ ovecc summary
Repository: ~/projects/acme-shop
Snapshot: snapshot:5ab78093fe96f36af8c75392
Files: 11
Modules: 6
Dependencies: 22
External dependencies: 6
Circular deps: 1
Boundary violations: 2
Coupling density: 26.67%
Risk score: High

Hotspots:
  services (score 10, fan-in 2, fan-out 2, instability 0.50)
  core (score 9, fan-in 3, fan-out 1, instability 0.25)
  routes (score 8, fan-in 1, fan-out 2, instability 0.67)
  src (score 6, fan-in 0, fan-out 2, instability 1.00)
  utils (score 4, fan-in 2, fan-out 0, instability 0.00)

Reading it​

  • Circular deps — number of strongly-connected (cyclic) module components. Get the actual cycles with query "cycles".
  • Coupling density — realized module edges over all possible directed edges; lower is looser coupling.
  • Hotspots — a quick structural ranking (the full churn/ownership-weighted ranking is hotspots).
  • Risk score — Low / Medium / High composite over cycles, boundary violations, and coupling.

JSON output (--format json) carries the same data with raw values — see the envelope description.

  • report — this plus findings, security, and hotspots in one document
  • metrics — the per-component numbers behind it