opschain runs converged
Included from Basic tier
opschain runs converged <run-id> [--step <step-id>] [--settings] [--exclude-layer <layer>]...
Reads the converged view a change records — the merged result of every
property layer at execution time, with each value attributed to the layer
that won it (the v2 ChangeService.GetConvergedProperties /
GetConvergedSettings reads). This is a
server verb, and it is about CHANGES: a workflow run records no converged
view of its own — each change the workflow created records one.
Flags
| Flag | Meaning |
|---|---|
--step <step-id> | Narrow to one step's pinned converged view instead of the change's (StepService.GetConvergedProperties; a step's --settings read resolves the step's change first, as v1 did) — the same step-id addressing the gate verbs use. |
--exclude-layer <layer> | Re-converge without this property layer (repeatable). A layer name, optionally suffixed _repository or _database — peel change, then asset, and watch a value fall through to the layer below. Properties only. |
--settings | Read the converged settings instead: the diff against the server's global settings, attributed per setting. The settings converge takes no layer filters. |
Output
The merged document as pretty-printed JSON, followed by the attribution table — each leaf value's dotted path against the layer that won it:
PROPERTY SOURCE
(the first column is SETTING with --settings; a value the server
attributes to no layer shows -). -o json|yaml prints one document with
id, data (the merged document) and sources (the per-value attribution
the server computed).
Exit codes
| Code | Meaning |
|---|---|
| 0 | Read. |
| 1 | The read failed — unknown run, a workflow-run id, or a server error. |
| 2 | Usage error — no server target, or a layer filter on the settings converge. |
Named errors
--exclude-layer applies to converged properties only — the settings converge takes no layer filters— exit 2.runs converged reads a server run's converged view — pass --server <url> or 'opschain context use <name>'— no server target (exit 2).run <id> is a workflow run, and workflow runs record no converged view of their own — each change the workflow created records one (runs show <id> lists its steps and their changes)— exit 1.run "<id>" not found on the server— exit 1.
Examples
The change's converged properties, then the same view without the change layer:
opschain runs converged 0199c81e-…
opschain runs converged 0199c81e-… --exclude-layer change
One step's pinned view, and the run's settings diff:
opschain runs converged 0199c81e-… --step 0199c8aa-…
opschain runs converged 0199c81e-… --settings
See also
opschain docs cli/runs-show— the run whose view this reads, and where a workflow run's changes are listed.opschain learn 1.3— properties and settings, including the converge.