"""活入口、SoT 与框架文档的 Markdown 链接死链门。"""

from __future__ import annotations

import pathlib
import re
import unittest
import urllib.parse

ROOT = next(
    parent
    for parent in (pathlib.Path(__file__).resolve().parent, *pathlib.Path(__file__).resolve().parents)
    if (parent / "AGENTS.md").is_file() and (parent / ".git").exists()
)
LINK = re.compile(r"\[[^\]\n]*\]\(([^)\s]+)")
STANDARD_INDEX_HEADER = (
    "| 名称 | 相对地址 | 内容描述 | 使用场景 | 使用要求 |\n"
    "|------|----------|----------|----------|----------|"
)


class MarkdownLinkTest(unittest.TestCase):
    def test_agent_content_directories_have_standard_indexes(self) -> None:
        agent_root = ROOT / ".agent"
        root_index = (agent_root / "目录.md").read_text(encoding="utf-8")
        missing: list[str] = []
        invalid_headers: list[str] = []
        undiscoverable: list[str] = []

        for directory in sorted(path for path in agent_root.iterdir() if path.is_dir()):
            index = directory / "目录.md"
            relative = index.relative_to(ROOT).as_posix()
            if not index.is_file():
                missing.append(relative)
                continue
            if not index.read_text(encoding="utf-8").startswith(STANDARD_INDEX_HEADER):
                invalid_headers.append(relative)
            if f"{directory.name}/目录.md" not in root_index:
                undiscoverable.append(relative)

        self.assertEqual(missing, [], "缺少一级目录索引：\n" + "\n".join(missing))
        self.assertEqual(
            invalid_headers,
            [],
            "一级目录索引未使用固定五列表头：\n" + "\n".join(invalid_headers),
        )
        self.assertEqual(
            undiscoverable,
            [],
            "一级目录索引未从 .agent/目录.md 登记：\n"
            + "\n".join(undiscoverable),
        )

    def test_active_markdown_links_resolve(self) -> None:
        roots = [
            ROOT / "AGENTS.md",
            ROOT / "README.md",
            ROOT / ".agent",
            ROOT / "framework",
            ROOT / "muse",
            ROOT / "docs",
        ]
        missing: list[str] = []
        for root in roots:
            files = [root] if root.is_file() else list(root.rglob("*.md"))
            for source in files:
                relative = source.relative_to(ROOT).as_posix()
                if relative.startswith("docs/plans/") or "/artifacts/" in relative:
                    continue
                for raw_target in LINK.findall(source.read_text(encoding="utf-8")):
                    target = urllib.parse.unquote(raw_target.strip("<>").split("#", 1)[0])
                    if not target or target.startswith(("#", "http://", "https://", "mailto:", "/")):
                        continue
                    if not (source.parent / target).resolve().exists():
                        missing.append(f"{relative}: {raw_target}")
        self.assertEqual(missing, [], "Markdown 链接目标不存在：\n" + "\n".join(missing))


if __name__ == "__main__":
    unittest.main()