"""Simple Markdown link checker for local docs/ files.

Checks only local file links (relative paths) and reports missing targets.

Run from the repository root using the project's Python environment.
"""

import re
from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent
DOCS = ROOT / "docs"

MD_LINK_RE = re.compile(r"\[([^\]]+)\]\(([^)]+)\)")

errors = []

for md in DOCS.rglob("*.md"):
    text = md.read_text(encoding="utf-8")
    for m in MD_LINK_RE.finditer(text):
        label, target = m.groups()
        # skip URLs
        if (
            target.startswith("http://")
            or target.startswith("https://")
            or target.startswith("#")
        ):
            continue
        # strip anchors
        target_path = target.split("#")[0]
        # if link is to a directory index, allow
        candidate = (md.parent / target_path).resolve()
        if candidate.exists():
            continue
        # check common implicit index: target/ -> target/README.md or target/index.md
        candidate_dir = md.parent / target_path
        if candidate_dir.is_dir():
            if (candidate_dir / "README.md").exists() or (
                candidate_dir / "index.md"
            ).exists():
                continue
        errors.append((str(md.relative_to(ROOT)), target, label))

if errors:
    print("Broken local links found:")
    for src, tgt, label in errors:
        print(f"- {src} -> {tgt}  ({label})")
    exit(2)

print("No broken local links detected.")