Record the job that published an overlay status

init/action.yml

@@ -159,6 +159,11 @@ inputs:
     description: >-
       Explicitly enable or disable caching of project build dependencies.
     required: false
+  check-run-id:
+    description: >-
+      [Internal] The ID of the check run, as provided by the Actions runtime environment. Do not set this value manually.
+    default: ${{ job.check_run_id }}
+    required: false
 outputs:
   codeql-path:
     description: The path of the CodeQL binary used for analysis

src/init-action-post-helper.ts

@@ -274,10 +274,17 @@ async function recordOverlayStatus(
     return;
   }
 
-  const overlayStatus: OverlayStatus = createOverlayStatus({
-    attemptedToBuildOverlayBaseDatabase: true,
-    builtOverlayBaseDatabase: false,
-  });
+  const checkRunIdInput = actionsUtil.getOptionalInput("check-run-id");
+  const checkRunId =
+    checkRunIdInput !== undefined ? parseInt(checkRunIdInput, 10) : undefined;
+
+  const overlayStatus: OverlayStatus = createOverlayStatus(
+    {
+      attemptedToBuildOverlayBaseDatabase: true,
+      builtOverlayBaseDatabase: false,
+    },
+    Number.isNaN(checkRunId) ? undefined : checkRunId,
+  );
 
   const diskUsage = await checkDiskUsage(logger);
   if (diskUsage === undefined) {

src/overlay/status.ts

@@ -45,6 +45,8 @@ function getStatusFilePath(languages: string[]): string {
 
 /** Details of the job that recorded an overlay status. */
 interface JobInfo {
+  /** The check run ID. This is optional since it is not always available. */
+  checkRunId?: number;
   /** The workflow run ID. */
   workflowRunId: number;
   /** The workflow run attempt number. */
@@ -66,14 +68,17 @@ export interface OverlayStatus {
 /** Creates an `OverlayStatus` populated with the details of the current job. */
 export function createOverlayStatus(
   attributes: Omit<OverlayStatus, "job">,
+  checkRunId?: number,
 ): OverlayStatus {
+  const job: JobInfo = {
+    workflowRunId: getWorkflowRunID(),
+    workflowRunAttempt: getWorkflowRunAttempt(),
+    name: getRequiredEnvParam("GITHUB_JOB"),
+    ...(checkRunId !== undefined && { checkRunId }),
+  };
   return {
     ...attributes,
-    job: {
-      workflowRunId: getWorkflowRunID(),
-      workflowRunAttempt: getWorkflowRunAttempt(),
-      name: getRequiredEnvParam("GITHUB_JOB"),
-    },
+    job,
   };
 }