opschain governance coverage
Included from Basic tier
opschain governance coverage --scope <node path> --from <t> [--to <t>] [--limit <n>]
Answers the coverage query (GovernanceService.GetCoverage): which change
runs and which break-glass records claim to have changed the node and its
subtree in the window [--from, --to), oldest first. Each row says how
exactly it can be matched against the target system's own audit log:
ATTRIBUTION reads REFERENCE when the activity carries an id the target
minted (the run's steps reported external references, or the record
carries reference evidence), WINDOW when it is attributable by its
window only. REFERENCES counts the run's external references (50+ when
truncated — opschain docs cli/governance-references lists them all).
-o json / -o yaml emit the activities (opschain docs resources/governed_activity).
Rows on nodes you cannot read, and break-glass records without read on
their <node>/breakglass rule path, never appear; a scope you cannot read
answers not found. On the local lane the query runs over the home's
store.
Flags
| Flag | Meaning |
|---|---|
--scope <node path> | The node whose subtree the query covers, e.g. /projects/web/environments/prod. Required. |
--from <t> | The window's start, an RFC3339 time. Required. |
--to <t> | The window's end, an RFC3339 time (default now). The window spans at most 366 days. |
--limit <n> | At most this many activities (default 100). |
Exit codes
| Code | Meaning |
|---|---|
| 0 | Answered (possibly nothing). |
| 1 | The server refused or is unreachable; the scope is not readable. |
| 2 | Usage error — no --scope or --from, a bad time, a window ending before it starts or over 366 days, a non-positive --limit. |
Examples
opschain governance coverage --scope /projects/hosted_ops/environments/prod --from 2026-11-17T22:00:00Z --to 2026-11-18T02:00:00Z
KIND ID NODE STARTED ENDED ATTRIBUTION STATUS REFERENCES
run 019a…-7c21 /projects/hosted_ops/environments/prod 2026-11-17T21:58:10Z 2026-11-17T23:05:42Z REFERENCE success 3
breakglass 019a…-81d0 /projects/hosted_ops/environments/prod 2026-11-17T22:40:00Z 2026-11-17T22:46:00Z REFERENCE unreconciled 0