Tune release failure alerts for tag runs with failed-job details

Author: ealdent

.github/workflows/release-failure-alert.yml

@@ -2,7 +2,7 @@ name: release-failure-alert
 
 on:
   workflow_run:
-    workflows: ["release"]
+    workflows: ["Release"]
     types: [completed]
 
 jobs:
@@ -18,6 +18,11 @@ jobs:
         with:
           script: |
             const run = context.payload.workflow_run;
+            if (run.event !== "push") {
+              core.info(`Skipping alert issue for non-tag release run event: ${run.event}`);
+              return;
+            }
+
             const owner = context.repo.owner;
             const repo = context.repo.repo;
             const runId = String(run.id);
@@ -29,6 +34,24 @@ jobs:
               return;
             }
 
+            const jobsResponse = await github.rest.actions.listJobsForWorkflowRun({
+              owner,
+              repo,
+              run_id: run.id,
+              per_page: 100
+            });
+
+            const failedJobs = jobsResponse.data.jobs.filter((job) =>
+              ["failure", "cancelled", "timed_out", "action_required", "stale"].includes(job.conclusion)
+            );
+
+            const failedJobLines = failedJobs.length === 0
+              ? ["- Failed jobs: unavailable"]
+              : [
+                  "- Failed jobs:",
+                  ...failedJobs.map((job) => `  - ${job.name}: ${job.html_url}`)
+                ];
+
             const body = [
               "Release workflow reported a failure.",
               "",
@@ -38,6 +61,7 @@ jobs:
               `- SHA: ${run.head_sha}`,
               `- Triggered by: ${run.actor?.login || "unknown"}`,
               `- Conclusion: ${run.conclusion}`,
+              ...failedJobLines,
               "",
               "Action: inspect failed jobs (artifact build/publish/verification) and apply runbook rollback/retry steps."
             ].join("\n");

docs/modernization-handoff.md

@@ -127,6 +127,7 @@ Delivered:
 - macOS Rust build linker guardrail (`dynamic_lookup`) for precompiled packaging paths
 - tag-driven release workflow (`.github/workflows/release.yml`)
 - release failure alert workflow (`.github/workflows/release-failure-alert.yml`)
+  - tuned to create issues only for failed tag-triggered release runs, with failed job links in alert body
 - maintainer release runbook (`docs/release-runbook.md`)
 - manual precompiled candidate workflow now validated on both lanes (`precompiled-candidate-evaluation.yml` run `22556129503`)
 - manual precompiled candidate workflow now validated with runtime checks on both lanes (`precompiled-candidate-evaluation.yml` run `22556206925`)
@@ -210,7 +211,7 @@ Priority 2:
 
 Priority 3:
 
-- monitor and tune release-failure issue alerting (`.github/workflows/release-failure-alert.yml`)
+- monitor tuned release-failure issue alerting (`.github/workflows/release-failure-alert.yml`) and adjust signal/noise as release cadence grows
 
 ## Resume Instructions For A New Conversation
 

docs/porting-strategy.md

@@ -85,7 +85,7 @@ Completed in `codex/experiment-ruby3-modernization`:
 - Post-publish verification helper added (`bin/verify-release-publish`) to validate RubyGems + GitHub release artifacts by tag.
 - CI precompiled guardrail job added (`precompiled-gem-build`) for Linux/macOS packaging checks.
 - Release workflow post-publish verification job added (`verify_published_artifacts`).
-- Release failure alert workflow added (`.github/workflows/release-failure-alert.yml`) to open issue alerts when `release.yml` fails.
+- Release failure alert workflow added (`.github/workflows/release-failure-alert.yml`) to open issue alerts for failed tag-triggered `release.yml` runs.
 - Maintainer release runbook added (`docs/release-runbook.md`) with publish and rollback/yank procedures.
 - Precompiled platform support policy added (`docs/precompiled-platform-policy.md`).
 

docs/release-runbook.md

@@ -144,7 +144,7 @@ Candidate expansion workflow:
    - environment-gated `publish_rubygems`
    - environment-gated `publish_github_release`
    - `verify_published_artifacts`
-   - on `release.yml` failure, `.github/workflows/release-failure-alert.yml` opens a triage issue
+   - on failed tag-triggered `release.yml` runs, `.github/workflows/release-failure-alert.yml` opens a triage issue with failed job links
 4. Approve the protected `release` environment when prompted.
 5. Confirm published outputs:
    - RubyGems shows `lda-ruby` `0.4.0` source gem and platform gems