chore: governance - tighten repo hygiene

scripts/check-doc-structure.py

@@ -7,9 +7,9 @@ import re
 import sys
 from pathlib import Path
 
+from lib.taxonomy import doc_readmes_from_taxonomy, taxonomy_sections
 
 ROOT = Path(__file__).resolve().parents[1]
-TAXONOMY = ROOT / "metadata/taxonomy.yml"
 SKIP_PARTS = {".git", ".history", "node_modules"}
 SKIP_PREFIXES = [
     Path(".github/wiki"),
@@ -19,69 +19,6 @@ ANCHOR_PATTERN = re.compile(r"<a\s+id=[\"']([^\"']+)[\"']")
 SUMMARY_LINE = "<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>"
 
 
-def strip_quotes(value: str) -> str:
-    return value.strip().strip("\"'")
-
-
-def taxonomy_sections() -> dict[str, dict[str, str]]:
-    sections: dict[str, dict[str, str]] = {}
-    current: str | None = None
-    in_sections = False
-
-    for line in TAXONOMY.read_text(encoding="utf-8").splitlines():
-        if line == "sections:":
-            in_sections = True
-            continue
-        if in_sections and line and not line.startswith(" "):
-            break
-        if not in_sections:
-            continue
-
-        section_match = re.match(r"^  ([A-Za-z0-9_-]+):\s*$", line)
-        if section_match:
-            current = section_match.group(1)
-            sections[current] = {}
-            continue
-        field_match = re.match(r"^    (path|entry|agent_guide):\s*(.+?)\s*$", line)
-        if current and field_match:
-            sections[current][field_match.group(1)] = strip_quotes(field_match.group(2))
-
-    return sections
-
-
-def taxonomy_document_paths() -> list[str]:
-    paths: list[str] = []
-    in_documents = False
-
-    for line in TAXONOMY.read_text(encoding="utf-8").splitlines():
-        if line == "documents:":
-            in_documents = True
-            continue
-        if in_documents and line and not line.startswith(" "):
-            break
-        if not in_documents:
-            continue
-
-        stripped = line.strip()
-        if stripped.startswith("- path:"):
-            _, value = stripped.split(":", 1)
-            paths.append(strip_quotes(value))
-
-    return paths
-
-
-def doc_readmes_from_taxonomy() -> dict[Path, list[str]]:
-    readmes: dict[Path, list[str]] = {}
-
-    for target in taxonomy_document_paths():
-        path_part, _, anchor = target.partition("#")
-        if not anchor or not path_part.startswith("docs/") or not path_part.endswith("/README.md"):
-            continue
-        readmes.setdefault(Path(path_part), []).append(anchor)
-
-    return readmes
-
-
 def strip_fenced_code(text: str) -> str:
     lines: list[str] = []
     in_fence = False