ovecc diff
Raw structural deltas between two stored snapshots (or Git refs): added/removed
modules, added/removed dependency edges, and a diff risk score. This is the
mechanical layer under gate and
review.
Usage: ovecc diff [OPTIONS] [BASE] [HEAD]
Example
$ ovecc diff
Architecture diff: snapshot:85ee2372… -> snapshot:5ab78093…
Added modules: 0
Removed modules: 0
Added dependencies: 4
Removed dependencies: 0
Risk: Medium
New dependencies:
core -> services (../services/billing)
routes -> external:child_process (child_process)
routes -> services (../services/orders)
routes -> services (../services/reports)
Each new edge names the import specifier that created it. Intra-module file wiring is excluded from the deltas — a new file importing its neighbor inside the same module is not an architecture change and doesn't inflate the risk score.
Options
| Option | Default | Effect |
|---|---|---|
[BASE] [HEAD] | previous latest | Snapshot ids or Git refs |
--fail-on <medium|high|any> | high | Exit 1 when the diff risk crosses the threshold |
Plus the global options.
note
Git refs resolve to snapshots taken at those commits — a ref only works if you
ran ovecc index while it was checked out. In PR pipelines, index base and head
explicitly (see CI integration).