Function find_strict_path_violations

ci/meson/path_normalization.py:208–249

Return human-readable strict-path violations in ``compile_commands.json``. Issue #2378 — every ``-I`` / ``-isystem`` / ``-iquote`` / ``-iframework`` / ``-idirafter`` / ``-imsvc`` / ``-include`` / ``-include-pch`` / ``-imacros`` / ``-F`` / ``/I`` path must be absolute, forward-slash, and

(build_dir: Path)

def find_strict_path_violations(build_dir: Path) -> list[str]:
    """Return human-readable strict-path violations in ``compile_commands.json``.

    Issue #2378 — every ``-I`` / ``-isystem`` / ``-iquote`` / ``-iframework`` /
    ``-idirafter`` / ``-imsvc`` / ``-include`` / ``-include-pch`` / ``-imacros``
    / ``-F`` / ``/I`` path must be absolute, forward-slash, and free of ``.``
    or ``..`` components. This is the same predicate enforced by
    ``ZCCACHE_STRICT_PATHS=absolute`` at compile time; checking it ourselves
    after meson setup lets us fail before ninja schedules any compile work.

    Returns an empty list when the file is missing (a fresh tree) or clean.
    """
    cc_json = build_dir / "compile_commands.json"
    if not cc_json.exists():
        return []
    try:
        data = json.loads(cc_json.read_text(encoding="utf-8"))
    except (OSError, json.JSONDecodeError):
        return []
    if not isinstance(data, list):
        return []

    violations: list[str] = []
    for entry in data:
        if not isinstance(entry, dict):
            continue
        entry_dict = cast(dict[str, object], entry)
        command = entry_dict.get("command")
        if not isinstance(command, str):
            continue
        for match in _STRICT_PATH_FLAG_RE.finditer(command):
            raw = match.group("path")
            normalized = raw.replace("\\", "/")
            if "\\" in raw:
                violations.append(f"{match.group('prefix').lstrip(chr(34))}{raw}")
                continue
            if not _is_forward_slash_absolute(normalized):
                violations.append(f"{match.group('prefix').lstrip(chr(34))}{raw}")
                continue
            if _has_dot_components(normalized):
                violations.append(f"{match.group('prefix').lstrip(chr(34))}{raw}")
    return violations


def _enforce_strict_path_violations(build_dir: Path) -> None: