Method check_needs_update

ci/fingerprint/core.py:425–479

Check if files need to be processed using two-layer detection. Delegates to ``zccache-fingerprint --cache-type two-layer check``. Exit 0 = run needed (files changed). Exit 1 = skip (cache hit, no changes). Use ``ext`` + ``root`` for fastest scanning (simple

(
        self,
        include: list[str] | None = None,
        exclude: list[str] | None = None,
        *,
        root: str = ".",
        ext: list[str] | None = None,
    )

        self.cache_file = self.fingerprint_dir / f"{subpath}.json"

    def check_needs_update(
        self,
        include: list[str] | None = None,
        exclude: list[str] | None = None,
        *,
        root: str = ".",
        ext: list[str] | None = None,
    ) -> bool:
        """
        Check if files need to be processed using two-layer detection.

        Delegates to ``zccache-fingerprint --cache-type two-layer check``.
        Exit 0 = run needed (files changed).
        Exit 1 = skip (cache hit, no changes).

        Use ``ext`` + ``root`` for fastest scanning (simple suffix match,
        scoped directory walk).  Use ``include`` for glob-pattern matching.

        Args:
            include: Glob patterns for files to monitor (e.g., ["src/**/*.cpp"]).
                     Cannot be combined with ``ext``.
            exclude: Optional patterns to exclude.
            root: Root directory for scanning (default: ".").
            ext: File extensions without dot (e.g., ["h", "cpp"]).
                 Faster than ``include`` — uses simple suffix match.
                 Cannot be combined with ``include``.

        Returns:
            True if processing is needed, False if cache is valid.
        """
        # zccache-fp 1.3.10 fails to canonicalize a relative "." root
        # ("scan error in : cannot canonicalize root"); always pass absolute.
        abs_root = str(Path(root).resolve())
        args = [
            "--cache-file",
            str(self.cache_file),
            "--cache-type",
            "two-layer",
            "check",
            "--root",
            abs_root,
        ]
        if ext:
            for e in ext:
                args.extend(["--ext", e])
        elif include:
            for pattern in include:
                args.extend(["--include", pattern])
        if exclude:
            for pattern in exclude:
                args.extend(["--exclude", pattern])

        result = _run_zccache(args)
        # exit 0 = run needed, exit 1 = skip (cache hit), exit 2+ = error (fail-safe: run)
        return result.returncode != 1

    def mark_success(self) -> None:
        """