ensure_all_relationships_in_views
Idempotent
Creates or reuses a coverage view to ensure every model relationship is rendered in at least one view, fixing unused relation warnings from Archi Validator.
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 | |||