Skip to main content
Version: v5.8.0

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​

FlagMeaning
--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​

CodeMeaning
0Answered (possibly nothing).
1The server refused or is unreachable; the scope is not readable.
2Usage 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