From 41c04075044ef31d3fd6c393ada760091fcf0b7f Mon Sep 17 00:00:00 2001 From: safishamsi Date: Thu, 17 Sep 2026 11:10:31 +0100 Subject: [PATCH] docs(diagnostics): note ref_ external refs and external=True stubs are distinct (#3590 follow-up) Co-Authored-By: Claude Opus 4.8 (1M context) --- graphify/diagnostics.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/graphify/diagnostics.py b/graphify/diagnostics.py index 32896494b..7e3baea6c 100644 --- a/graphify/diagnostics.py +++ b/graphify/diagnostics.py @@ -203,6 +203,11 @@ def diagnose_extraction( missing_endpoint_edges += 1 continue if source not in node_ids or target not in node_ids: + # Two intentionally-distinct populations of "external": a `ref_` + # target here is a JSON/config out-of-corpus reference ($ref / + # extends / references), whereas import-family externals are minted + # as declared `external=True` stub nodes at build time (#2873) and + # therefore never reach this branch. Don't try to unify them. if source in node_ids and target.startswith("ref_"): external_reference_edges += 1 else: