docs verify: nur als .template ausgeliefertes Linkziel gilt als aufgeloest (Defekt aus 0fb8fd6)

Files changed:
- CHANGES.md
- VERSION
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/tests/test_docs_verify.py

tools/chemenu/commands/docs_verify.py

@@ -470,6 +470,13 @@ def check_toc_regions() -> list[str]:
 # escaping, which nothing here uses.
 MARKDOWN_LINK_RE = re.compile(r"\[[^\]]*\]\(([^)\s]+)\)")
 
+# The suffix `dist export` re-keys an instance-owned file to, and the one
+# `setup-instance.md` renames away again. Spelled here rather than imported
+# from `ownership`, whose own `.template` handling answers a different
+# question (which side an upstream merge keeps) over a narrower scope
+# (paths under a content stage).
+TEMPLATE_SUFFIX = ".template"
+
 
 def is_external_or_anchor(target: str) -> bool:
     """A link this check does not resolve as a filesystem path: an absolute
@@ -498,6 +505,17 @@ def check_reference_targets() -> list[str]:
     a stale one anyway. Code fences and inline code spans are masked first
     (`markdown_code.strip_code_spans`), so a passage that shows link syntax
     as an example is not mistaken for a real reference.
+
+    **A target the stack ships only as a `.template` counts as resolving.**
+    `kb/CONVENTIONS.md` and every `kb/<name>/COLLECTION.md` are instance-owned:
+    a distribution carries `<name>.template` and the instance adopts it by
+    renaming, during `instructions/setup-instance.md`'s personalization step.
+    Between `dist export` and that step the real file legitimately does not
+    exist yet - while `kb/CONTRACT.md` and three flat instructions link to it
+    by its adopted name, correctly, because that is the name it will have.
+    Reporting those as dead links would fail a fresh export for doing exactly
+    what it is supposed to do, and would describe "not personalized yet" as a
+    broken link when `doctor`'s `conventions` check already says it precisely.
     """
     issues = []
     for path in toc.target_files():
@@ -511,11 +529,15 @@ def check_reference_targets() -> list[str]:
                 target_path = target.split("#", 1)[0]
                 if not target_path:
                     continue
-                if not (path.parent / target_path).resolve().exists():
-                    issues.append(
-                        f"{rel_path(path)}:{line_number} links to `{target}`, which does not "
-                        "resolve to an existing file"
-                    )
+                resolved = (path.parent / target_path).resolve()
+                if resolved.exists():
+                    continue
+                if resolved.with_name(resolved.name + TEMPLATE_SUFFIX).exists():
+                    continue
+                issues.append(
+                    f"{rel_path(path)}:{line_number} links to `{target}`, which does not "
+                    "resolve to an existing file"
+                )
     return issues