add run-command and run-build modules

Author: mw-kapilg

.npmrc

@@ -1 +1 @@
-registry=https://registry.npmjs.org/
+registry=https://registry.npmjs.org/

package-lock.json

@@ -14,7 +14,7 @@
         "package": "ncc build --minify",
         "test": "jest",
         "all": "npm test && npm run build && npm run package",
-        "ci": "npm run clean && npm run deps && npm ci && npm run all"
+        "ci": "npm run clean && npm ci && npm run deps && npm run all"
     },
     "files": [
         "lib/",
@@ -23,7 +23,8 @@
     ],
     "dependencies": {
         "@actions/core": "^1.11.1",
-        "@actions/exec": "^1.1.1"
+        "@actions/exec": "^1.1.1",
+        "uuid": "^11.1.0"
     },
     "devDependencies": {
         "@types/jest": "^30.0.0",

package.json

@@ -0,0 +1,48 @@
+% rename and restructure all plugins
+classdef BuildSummaryPlugin < matlab.buildtool.plugins.BuildRunnerPlugin
+
+%   Copyright 2024 The MathWorks, Inc.
+
+    properties (Access=private)
+        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");
+            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));
+                s = jsonencode(plugin.TaskDetails);
+                fprintf(fID, "%s",s);
+            end
+        end
+
+        function runTask(plugin, pluginData)
+            runTask@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
+
+            taskDetail = getCommonTaskDetail(pluginData);
+            plugin.TaskDetails = [plugin.TaskDetails, taskDetail];
+        end
+
+        function skipTask(plugin, pluginData)
+            skipTask@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
+
+            taskDetail = getCommonTaskDetail(pluginData);
+            taskDetail.skipReason = pluginData.SkipReason;
+            plugin.TaskDetails = [plugin.TaskDetails, taskDetail];
+        end
+    end
+end
+
+function taskDetail = getCommonTaskDetail(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

plugins/+ciplugins/+github/BuildSummaryPlugin.m

@@ -0,0 +1,22 @@
+classdef GitHubLogBuildRunnerPlugin < matlab.buildtool.plugins.BuildRunnerPlugin
+
+%   Copyright 2024 The MathWorks, Inc.
+
+    methods (Access=protected)
+
+        function runTask(plugin, pluginData)
+           % Add Github workflow command for grouping the tasks
+           disp("::group::" + pluginData.TaskResults.Name);
+
+           runTask@matlab.buildtool.plugins.BuildRunnerPlugin(plugin, pluginData);
+
+           % Add Github workflow command ::error:: if the task is failed
+           if pluginData.TaskResults.Failed
+              disp("::error::" + pluginData.TaskResults.Name + " task failed");
+           end
+
+           % Complete the group command
+           disp("::endgroup::");
+        end
+    end
+ end