ensure_all_relationships_in_views
Idempotent
Automatically creates or reuses a coverage view to include all missing relationships, ensuring every connection in the model appears in a view and fixing unused relation warnings.
Instructions
Ensure every model relationship is rendered in at least one view.
Useful when Archi Validator reports `Unused Relation` or
`'Serving relation' is not used in a View`. The tool creates or
reuses a coverage view, adds the missing endpoint nodes, and adds
the missing connections. It also relocates redundant
Grouping-to-contained-child Aggregation/Composition connections out
of readable views into the coverage view (containment communicates
the meaning visually instead).
Coverage views are marked with the `mcp:relationship_coverage_view`
property, so future invocations recognize them regardless of the
display name.
Args:
coverage_view_name: Name of the coverage view. If a view with
this name exists, it is reused; otherwise it is created.
auto_layout: When true (default), lay out the affected views
after adding nodes and connections.
layout_strategy: Validated for consistency with other layout
tools but not applied — the coverage view layout is a fixed
source/target pair grid.
layout_engine: Must be `internal` (the default). The coverage
layout is a fixed pair grid, so no other engine can be
honoured here and passing one is an error rather than a
silently ignored hint.
rollback_on_error: When true (default), restore the previous
model state if coverage creation fails.
Returns:
Success envelope with `data` containing the coverage view ID,
added node and connection counts, relocated containment
connection counts, skipped relationship IDs, and remaining
unused relationship IDs.
Errors:
`ModelNotFoundError` if no model is active.
`ModelOperationError` for an unknown layout strategy/engine
(with `error.details.suggestions`), or for any engine other
than `internal`. Both are validated whether or not
`auto_layout` is true.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_layout | No | ||
| layout_engine | No | internal | |
| layout_strategy | No | layered_by_type | |
| rollback_on_error | No | ||
| coverage_view_name | No | Relationship Coverage |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||