Method try_download_build_summary

ci/tools/gh_debug.py:166–254

Try to download build-summary artifacts for faster analysis. Build-summary artifacts are small, focused files uploaded by CI containing just the error output. Much faster than downloading full logs. Returns: Path to combined summary file, or None if not availabl

(self)

            return []

    def try_download_build_summary(self) -> Optional[Path]:
        """Try to download build-summary artifacts for faster analysis.

        Build-summary artifacts are small, focused files uploaded by CI
        containing just the error output. Much faster than downloading full logs.

        Returns:
            Path to combined summary file, or None if not available
        """
        try:
            # List artifacts for this run
            result = subprocess.run(
                [
                    "gh",
                    "api",
                    f"repos/{self.repo}/actions/runs/{self.run_id}/artifacts",
                    "--jq",
                    '.artifacts[] | select(.name | startswith("build-summary")) | .name',
                ],
                capture_output=True,
                text=True,
                check=True,
                timeout=15,
            )

            artifact_names = [
                n.strip() for n in result.stdout.strip().split("\n") if n.strip()
            ]
            if not artifact_names:
                print("No build-summary artifacts found for this run")
                return None

            print(f"Found {len(artifact_names)} build-summary artifact(s)")

            # Download artifacts
            download_dir = Path(".logs/gh/summaries") / f"run_{self.run_id}"
            download_dir.mkdir(parents=True, exist_ok=True)

            for name in artifact_names:
                try:
                    subprocess.run(
                        [
                            "gh",
                            "run",
                            "download",
                            self.run_id,
                            "-n",
                            name,
                            "-D",
                            str(download_dir),
                        ],
                        capture_output=True,
                        text=True,
                        check=True,
                        timeout=30,
                    )
                except KeyboardInterrupt as ki:
                    handle_keyboard_interrupt(ki)