For AI agents: the complete documentation index is available at https://mfdoctor.kevinbeier.com/llms.txt, the full documentation bundle is available at https://mfdoctor.kevinbeier.com/llms-full.txt, and this page is available as Markdown at https://mfdoctor.kevinbeier.com/rules/federation/circular-remote-graph.md.

federation/circular-remote-graph

  • Category: reliability
  • Default severity: warning

Issue

A remote cycle is valid Module Federation topology by itself. MFDoctor warns only when a strongly connected group contains a version-first member that eagerly loads a remote during startup.

How to fix it

Keep valid loaded-first bi-directional setups. For a risky cycle, use loaded-first, add startup fallback handling, or make the remote edge on the startup path lazy.

Suppress or retarget with rules["federation/circular-remote-graph"] set to "off" or a severity — see Suppressions and allowlists.

Sources