Add skip reason for skipped tasks in build summary table

plugins/+ciplugins/+github/BuildSummaryPlugin.m

@@ -2,27 +2,48 @@
 
 %   Copyright 2024 The MathWorks, Inc.
 
-    methods (Access=protected)
+    properties
+        taskDetails = {};
+    end
 
+    methods (Access=protected)
         function runTaskGraph(plugin, pluginData)
             runTaskGraph@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
-            [fID, msg] = fopen(fullfile(getenv("RUNNER_TEMP") ,"buildSummary" + getenv("GITHUB_RUN_ID") + ".json"), "w");
 
+            [fID, msg] = fopen(fullfile(getenv("RUNNER_TEMP") ,"buildSummary" + getenv("GITHUB_RUN_ID") + ".json"), "w");
             if fID == -1
                 warning("ciplugins:github:BuildSummaryPlugin:UnableToOpenFile","Unable to open a file required to create the MATLAB build summary table: %s", msg);
             else
                 closeFile = onCleanup(@()fclose(fID));
-                taskDetails = struct();
-                for idx = 1:numel(pluginData.TaskResults)
-                    taskDetails(idx).name = pluginData.TaskResults(idx).Name;
-                    taskDetails(idx).description = pluginData.TaskGraph.Tasks(idx).Description;
-                    taskDetails(idx).failed = pluginData.TaskResults(idx).Failed;
-                    taskDetails(idx).skipped = pluginData.TaskResults(idx).Skipped;
-                    taskDetails(idx).duration = string(pluginData.TaskResults(idx).Duration);
-                end
-                s = jsonencode(taskDetails);
+                s = jsonencode(plugin.taskDetails);
                 fprintf(fID, "%s",s);
             end
         end
+
+        function runTask(plugin, pluginData)
+            runTask@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
+
+            taskDetail = plugin.getCommonTaskData(pluginData);
+            plugin.taskDetails = [plugin.taskDetails, taskDetail];
+        end
+
+        function skipTask(plugin, pluginData)
+            skipTask@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
+
+            taskDetail = plugin.getCommonTaskData(pluginData);
+            taskDetail.skipReason = pluginData.SkipReason;
+            plugin.taskDetails = [plugin.taskDetails, taskDetail];
+        end
+    end
+
+    methods(Static, Access=private)
+        function taskDetail = getCommonTaskData(pluginData)
+            taskDetail = struct();
+            taskDetail.name = pluginData.TaskResults.Name;
+            taskDetail.description = pluginData.TaskGraph.Tasks.Description;
+            taskDetail.failed = pluginData.TaskResults.Failed;
+            taskDetail.skipped = pluginData.TaskResults.Skipped;
+            taskDetail.duration = string(pluginData.TaskResults.Duration);
+        end
     end
 end

src/buildSummary.ts

@@ -3,14 +3,6 @@ import * as core from "@actions/core";
 import { join } from 'path';
 import { readFileSync, unlinkSync, existsSync } from 'fs';
 
-export interface Task {
-    name: string;
-    description: string;
-    failed: boolean;
-    skipped: boolean;
-    duration: string;
-}
-
 export function writeSummary(taskSummaryTableRows: string[][]) {
     try {
         core.summary
@@ -26,14 +18,29 @@ export function getSummaryRows(buildSummary: string): any[] {
         if (t.failed) {
             return [t.name, '🔴 Failed', t.description, t.duration.toString()];
         } else if (t.skipped) {
-            return [t.name, '🔵 Skipped', t.description, t.duration.toString()];
+            return [t.name, '🔵 Skipped' + ' (' + interpretSkipReason(t.skipReason) + ')', t.description, t.duration.toString()];
         } else {
             return [t.name, '🟢 Success', t.description, t.duration.toString()];
         }
     });
     return rows;
 }
 
+export function interpretSkipReason(skipReason: string){
+    switch(skipReason) {
+        case "UpToDate":
+            return "Up-To-Date";
+        case "UserSpecified":
+            return "User Specified";
+        case "UserRequested":
+            return "User Requested";
+        case "DependencyFailed":
+            return "Dependency Failed";
+        default:
+            return skipReason;
+    }
+}
+
 export function processAndDisplayBuildSummary() {
     const runId = process.env.GITHUB_RUN_ID || '';
     const runnerTemp = process.env.RUNNER_TEMP || '';

src/buildSummary.unit.test.ts

@@ -15,15 +15,15 @@ describe('summaryGeneration', () => {
     it('should process and return summary rows for valid JSON with different task statuses', () => {
         const mockBuildSummary = JSON.stringify([
             { name: 'Task 1', failed: true, skipped: false, description: 'Task 1 description', duration: '00:00:10' },
-            { name: 'Task 2', failed: false, skipped: true, description: 'Task 2 description', duration: '00:00:20' },
+            { name: 'Task 2', failed: false, skipped: true, skipReason: 'UserSpecified', description: 'Task 2 description', duration: '00:00:20' },
             { name: 'Task 3', failed: false, skipped: false, description: 'Task 3 description', duration: '00:00:30' }
         ]);
 
         const result = buildSummary.getSummaryRows(mockBuildSummary);
 
         expect(result).toEqual([
             ['Task 1', '🔴 Failed', 'Task 1 description', '00:00:10'],
-            ['Task 2', '🔵 Skipped', 'Task 2 description', '00:00:20'],
+            ['Task 2', '🔵 Skipped (User Specified)', 'Task 2 description', '00:00:20'],
             ['Task 3', '🟢 Success', 'Task 3 description', '00:00:30']
         ]);
     });