From aaa6f7579239fc128dadbd5b652d0027b304fa5e Mon Sep 17 00:00:00 2001
From: zaebee <305761+zaebee@users.noreply.github.com>
Date: Fri, 23 Oct 2026 09:23:49 +0000
Subject: [PATCH] docs: auto-sync architecture graph and MCP reference

---
 docs/how-to/MCP_REFERENCE.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/how-to/MCP_REFERENCE.md b/docs/how-to/MCP_REFERENCE.md
index 02764bed..86824de6 100644
--- a/docs/how-to/MCP_REFERENCE.md
+++ b/docs/how-to/MCP_REFERENCE.md
@@ -417,7 +417,11 @@ How one package is built inside: its modules and the dependencies between them.
     shows; an edge that closes a cycle is never dropped. Dependencies on code
     outside the package are summarised per module under the diagram, not drawn.
     Test modules and type-only imports are left out. The json form is
-    ``{prefix, nodes, subpackages, edges:[{source,target,kind}], dropped, outside}``.
+    ``{prefix, nodes, subpackages, edges:[{source,target,kind}], dropped, covered, outside}``;
+    ``covered`` counts the imports not drawn because a drawn ``==>`` joins the
+    same pair: that arrow then also stands for the import, so read an import
+    closure over imports and extends together. An import that closes an import
+    cycle is always drawn.
     Run ``cgis_ingest`` first.
 
 | Argument | Type | Required | Description |