feat(calm-widgets): add ignore-connected-interfaces option to block-architecture widget

[markscott-ms]

Description

Closes #1600

Adds a new ignore-connected-interfaces boolean option to the block-architecture widget.

When using focus-interfaces with edges=connected and render-interfaces=true, the widget currently renders all interfaces on every visible node — including unrelated ones on connected nodes. This makes the diagram cluttered and harder to read when the user is trying to understand a specific interface and its connections.

With ignore-connected-interfaces=true, only the interfaces that actually participate in the active relationships are rendered. All other interfaces (on seed nodes and connected nodes alike) are hidden. Edges still route to the interface sub-nodes, which are now correctly rendered.

Example (payment architecture)

Focusing on payment-api with edges=connected render-interfaces=true:

Interface	Without option	With ignore-connected-interfaces=true
payment-api (seed)	✅ shown	✅ shown
fraud-check-api (active destination)	✅ shown	✅ shown
email-iface (active destination)	✅ shown	✅ shown
audit-log-iface (seed, not in any active rel)	✅ shown	❌ hidden
risk-model-iface, score-db-iface (connected, inactive)	✅ shown	❌ hidden
sms-iface (connected, inactive)	✅ shown	❌ hidden

Screenshots

Without ignore-connected-interfaces (existing behaviour)

{{block-architecture focus-interfaces="payment-api" render-interfaces=true edges="connected"}}

With ignore-connected-interfaces=true (new behaviour)

{{block-architecture focus-interfaces="payment-api" render-interfaces=true edges="connected" ignore-connected-interfaces=true}}

Type of Change

• 🐛 Bug fix (non-breaking change which fixes an issue)
• ✨ New feature (non-breaking change which adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
• 📚 Documentation update
• 🎨 Code style/formatting changes
• ♻️ Refactoring (no functional changes)
• ⚡ Performance improvements
• ✅ Test additions or updates
• 🔧 Chore (maintenance, dependencies, CI, etc.)

Affected Components

• CLI (cli/)
• Schema (calm/)
• CALM AI (calm-ai/)
• CALM Hub (calm-hub/)
• CALM Hub UI (calm-hub-ui/)
• CALM Server (calm-server/)
• CALM Widgets (calm-widgets/)
• Documentation (docs/)
• Shared (shared/)
• VS Code Extension (calm-plugins/vscode/)
• Dependencies
• CI/CD

Commit Message Format ✅

feat(calm-widgets): add ignore-connected-interfaces option to block-architecture widget

Testing

• I have tested my changes locally
• I have added/updated unit tests
• All existing tests pass

New tests added:

• node-factory.spec.ts: filters interfaces by activeInterfaceIds; produces no interfaces when set is empty
• container-builder.spec.ts: passes activeInterfaceIds through to the node factory
• options-parser.spec.ts: parses ignore-connected-interfaces option
• E2E fixture ignore-connected-interfaces/: side-by-side before/after using a 3-node payment architecture

Checklist

• My commits follow the conventional commit format
• I have updated documentation if necessary
• I have added tests for my changes (if applicable)
• My changes follow the project's coding standards

[Copilot]

Pull request overview

Adds a new ignore-connected-interfaces option to the block-architecture widget (calm-widgets) to declutter focused interface views by rendering only interfaces that participate in the currently active/filtered relationships.

Changes:

• Introduces the ignore-connected-interfaces option (types + parsing) and threads an activeInterfaceIds allowlist into VM construction.
• Updates node/container VM factories to optionally filter rendered interfaces, with unit coverage for the new filtering behavior.
• Adds an end-to-end fixture demonstrating before/after output and documents the new option in calm-widgets/README.md.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
calm-widgets/test-fixtures/block-architecture-widget/ignore-connected-interfaces/template.hbs	New fixture template showing before/after usage of the option.
calm-widgets/test-fixtures/block-architecture-widget/ignore-connected-interfaces/expected.md	Expected Mermaid output for the new fixture (before/after).
calm-widgets/test-fixtures/block-architecture-widget/ignore-connected-interfaces/context.json	Fixture model containing interfaces + relationships to exercise filtering.
calm-widgets/src/widgets/block-architecture/types.ts	Adds the new option to public and normalized options types.
calm-widgets/src/widgets/block-architecture/core/vm-builder.ts	Computes and passes “active interfaces” allowlist into container/node building.
calm-widgets/src/widgets/block-architecture/core/visibility-resolver.ts	Extends VisibilityResult to expose seedNodes from strategies.
calm-widgets/src/widgets/block-architecture/core/options-parser.ts	Parses ignore-connected-interfaces into normalized options.
calm-widgets/src/widgets/block-architecture/core/options-parser.spec.ts	Unit tests for parsing the new option.
calm-widgets/src/widgets/block-architecture/core/factories/vm-factory-interfaces.ts	Extends VMNodeFactory.createLeafNode signature to accept activeInterfaceIds.
calm-widgets/src/widgets/block-architecture/core/factories/node-factory.ts	Filters rendered interfaces using the passed allowlist.
calm-widgets/src/widgets/block-architecture/core/factories/node-factory.spec.ts	Unit tests for interface filtering behavior (including empty allowlist).
calm-widgets/src/widgets/block-architecture/core/builders/container-builder.ts	Threads activeInterfaceIds through to the node factory.
calm-widgets/src/widgets/block-architecture/core/builders/container-builder.spec.ts	Verifies activeInterfaceIds are passed to the node factory.
calm-widgets/src/widgets.e2e.spec.ts	Adds an E2E test that runs the new fixture.
calm-widgets/README.md	Documents the new widget option and links the new fixture example.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.