feat: add activation-comments to disable activation/fallback bot comments

actions/setup/js/add_workflow_run_comment.cjs

@@ -6,6 +6,8 @@ const { getErrorMessage } = require("./error_helpers.cjs");
 const { generateWorkflowIdMarker } = require("./generate_footer.cjs");
 const { sanitizeContent } = require("./sanitize_content.cjs");
 const { ERR_NOT_FOUND, ERR_VALIDATION } = require("./error_codes.cjs");
+const { getMessages } = require("./messages_core.cjs");
+const { parseBoolTemplatable } = require("./templatable.cjs");
 
 /**
  * Event type descriptions for comment messages
@@ -60,6 +62,13 @@ function setCommentOutputs(commentId, commentUrl) {
  * Use add_reaction.cjs in the pre-activation job to add reactions first for immediate feedback.
  */
 async function main() {
+ // Check if activation comments are disabled
+ const messagesConfig = getMessages();
+ if (!parseBoolTemplatable(messagesConfig?.activationComments, true)) {
+ core.info("activation-comments is disabled: skipping activation comment creation");
+ return;
+ }
+
  const runId = context.runId;
  const githubServer = process.env.GITHUB_SERVER_URL || "https://github.com";
  const runUrl = context.payload.repository ? `${context.payload.repository.html_url}/actions/runs/${runId}` : `${githubServer}/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;

actions/setup/js/generate_footer.cjs

@@ -43,6 +43,8 @@ function generateXMLMarker(workflowName, runUrl) {
  const engineVersion = process.env.GH_AW_ENGINE_VERSION || "";
  const engineModel = process.env.GH_AW_ENGINE_MODEL || "";
  const trackerId = process.env.GH_AW_TRACKER_ID || "";
+ const runId = process.env.GITHUB_RUN_ID || "";
+ const workflowId = process.env.GH_AW_WORKFLOW_ID || "";
 
  // Build the key-value pairs for the marker
  const parts = [];
@@ -70,6 +72,16 @@ function generateXMLMarker(workflowName, runUrl) {
  parts.push(`model: ${engineModel}`);
  }
 
+ // Add numeric run ID if available
+ if (runId) {
+ parts.push(`id: ${runId}`);
+ }
+
+ // Add workflow identifier if available
+ if (workflowId) {
+ parts.push(`workflow_id: ${workflowId}`);
+ }
+
  // Always include run URL
  parts.push(`run: ${runUrl}`);
 

actions/setup/js/generate_footer.test.cjs

@@ -45,6 +45,7 @@ describe("generate_footer.cjs", () => {
  delete process.env.GH_AW_ENGINE_MODEL;
  delete process.env.GH_AW_TRACKER_ID;
  delete process.env.GH_AW_WORKFLOW_ID;
+ delete process.env.GITHUB_RUN_ID;
 
  // Dynamic import to get fresh module state
  const module = await import("./generate_footer.cjs");
@@ -126,6 +127,42 @@ describe("generate_footer.cjs", () => {
 
  expect(result).toBe("<!-- gh-aw-agentic-workflow: Test Workflow, gh-aw-tracker-id: workflow-2024-q1, engine: copilot, version: 1.0.0, model: gpt-5, run: https://github.com/test/repo/actions/runs/123 -->");
  });
+
+ it("should include run id when GITHUB_RUN_ID env var is set", async () => {
+ process.env.GITHUB_RUN_ID = "9876543210";
+
+ vi.resetModules();
+ const freshModule = await import("./generate_footer.cjs");
+
+ const result = freshModule.generateXMLMarker("Test Workflow", "https://github.com/test/repo/actions/runs/9876543210");
+
+ expect(result).toBe("<!-- gh-aw-agentic-workflow: Test Workflow, id: 9876543210, run: https://github.com/test/repo/actions/runs/9876543210 -->");
+ });
+
+ it("should include workflow_id when GH_AW_WORKFLOW_ID env var is set", async () => {
+ process.env.GH_AW_WORKFLOW_ID = "smoke-copilot";
+
+ vi.resetModules();
+ const freshModule = await import("./generate_footer.cjs");
+
+ const result = freshModule.generateXMLMarker("Test Workflow", "https://github.com/test/repo/actions/runs/123");
+
+ expect(result).toBe("<!-- gh-aw-agentic-workflow: Test Workflow, workflow_id: smoke-copilot, run: https://github.com/test/repo/actions/runs/123 -->");
+ });
+
+ it("should include all identifiers when all standard env vars are set", async () => {
+ process.env.GH_AW_ENGINE_ID = "copilot";
+ process.env.GH_AW_TRACKER_ID = "tracker-abc";
+ process.env.GITHUB_RUN_ID = "12345";
+ process.env.GH_AW_WORKFLOW_ID = "my-workflow";
+
+ vi.resetModules();
+ const freshModule = await import("./generate_footer.cjs");
+
+ const result = freshModule.generateXMLMarker("My Workflow", "https://github.com/test/repo/actions/runs/12345");
+
+ expect(result).toBe("<!-- gh-aw-agentic-workflow: My Workflow, gh-aw-tracker-id: tracker-abc, engine: copilot, id: 12345, workflow_id: my-workflow, run: https://github.com/test/repo/actions/runs/12345 -->");
+ });
  });
 
  describe("generateWorkflowIdMarker", () => {

actions/setup/js/messages_core.cjs

@@ -33,10 +33,14 @@
  * @property {string} [runSuccess] - Custom workflow success message template
  * @property {string} [runFailure] - Custom workflow failure message template
  * @property {string} [detectionFailure] - Custom detection job failure message template
+ * @property {string} [pullRequestCreated] - Custom template for pull request creation link. Placeholders: {item_number}, {item_url}
+ * @property {string} [issueCreated] - Custom template for issue creation link. Placeholders: {item_number}, {item_url}
+ * @property {string} [commitPushed] - Custom template for commit push link. Placeholders: {commit_sha}, {short_sha}, {commit_url}
  * @property {string} [agentFailureIssue] - Custom footer template for agent failure tracking issues
  * @property {string} [agentFailureComment] - Custom footer template for comments on agent failure tracking issues
  * @property {string} [closeOlderDiscussion] - Custom message for closing older discussions as outdated
  * @property {boolean} [appendOnlyComments] - If true, create new comments instead of updating the activation comment
+ * @property {string|boolean} [activationComments] - If false or "false", disable all activation/fallback comments entirely. Supports templatable boolean values (default: true)
  */
 
 /**

actions/setup/js/messages_footer.cjs

@@ -171,6 +171,8 @@ function generateXMLMarker(workflowName, runUrl) {
  const engineVersion = process.env.GH_AW_ENGINE_VERSION || "";
  const engineModel = process.env.GH_AW_ENGINE_MODEL || "";
  const trackerId = process.env.GH_AW_TRACKER_ID || "";
+ const runId = process.env.GITHUB_RUN_ID || "";
+ const workflowId = process.env.GH_AW_WORKFLOW_ID || "";
 
  // Build the key-value pairs for the marker
  const parts = [];
@@ -198,6 +200,16 @@ function generateXMLMarker(workflowName, runUrl) {
  parts.push(`model: ${engineModel}`);
  }
 
+ // Add numeric run ID if available
+ if (runId) {
+ parts.push(`id: ${runId}`);
+ }
+
+ // Add workflow identifier if available
+ if (workflowId) {
+ parts.push(`workflow_id: ${workflowId}`);
+ }
+
  // Always include run URL
  parts.push(`run: ${runUrl}`);
 

actions/setup/js/messages_run_status.cjs

@@ -108,9 +108,67 @@ function getDetectionFailureMessage(ctx) {
  return messages?.detectionFailure ? renderTemplate(messages.detectionFailure, templateContext) : renderTemplate(defaultMessage, templateContext);
 }
 
+/**
+ * @typedef {Object} PullRequestCreatedContext
+ * @property {number} itemNumber - PR number
+ * @property {string} itemUrl - URL of the pull request
+ */
+
+/**
+ * Get the pull-request-created message, using custom template if configured.
+ * @param {PullRequestCreatedContext} ctx - Context for message generation
+ * @returns {string} Pull-request-created message
+ */
+function getPullRequestCreatedMessage(ctx) {
+ const messages = getMessages();
+ const templateContext = toSnakeCase(ctx);
+ const defaultMessage = "Pull request created: [#{item_number}]({item_url})";
+ return messages?.pullRequestCreated ? renderTemplate(messages.pullRequestCreated, templateContext) : renderTemplate(defaultMessage, templateContext);
+}
+
+/**
+ * @typedef {Object} IssueCreatedContext
+ * @property {number} itemNumber - Issue number
+ * @property {string} itemUrl - URL of the issue
+ */
+
+/**
+ * Get the issue-created message, using custom template if configured.
+ * @param {IssueCreatedContext} ctx - Context for message generation
+ * @returns {string} Issue-created message
+ */
+function getIssueCreatedMessage(ctx) {
+ const messages = getMessages();
+ const templateContext = toSnakeCase(ctx);
+ const defaultMessage = "Issue created: [#{item_number}]({item_url})";
+ return messages?.issueCreated ? renderTemplate(messages.issueCreated, templateContext) : renderTemplate(defaultMessage, templateContext);
+}
+
+/**
+ * @typedef {Object} CommitPushedContext
+ * @property {string} commitSha - Full commit SHA
+ * @property {string} shortSha - Short (7-char) commit SHA
+ * @property {string} commitUrl - URL of the commit
+ */
+
+/**
+ * Get the commit-pushed message, using custom template if configured.
+ * @param {CommitPushedContext} ctx - Context for message generation
+ * @returns {string} Commit-pushed message
+ */
+function getCommitPushedMessage(ctx) {
+ const messages = getMessages();
+ const templateContext = toSnakeCase(ctx);
+ const defaultMessage = "Commit pushed: [`{short_sha}`]({commit_url})";
+ return messages?.commitPushed ? renderTemplate(messages.commitPushed, templateContext) : renderTemplate(defaultMessage, templateContext);
+}
+
 module.exports = {
  getRunStartedMessage,
  getRunSuccessMessage,
  getRunFailureMessage,
  getDetectionFailureMessage,
+ getPullRequestCreatedMessage,
+ getIssueCreatedMessage,
+ getCommitPushedMessage,
 };

actions/setup/js/notify_comment_error.cjs

@@ -11,6 +11,7 @@ const { getMessages } = require("./messages_core.cjs");
 const { getErrorMessage, isLockedError } = require("./error_helpers.cjs");
 const { sanitizeContent } = require("./sanitize_content.cjs");
 const { ERR_VALIDATION } = require("./error_codes.cjs");
+const { parseBoolTemplatable } = require("./templatable.cjs");
 
 /**
  * Collect generated asset URLs from safe output jobs
@@ -60,6 +61,12 @@ async function main() {
  const messagesConfig = getMessages();
  const appendOnlyComments = messagesConfig?.appendOnlyComments === true;
 
+ // If activation comments are disabled entirely, skip all comment updates
+ if (!parseBoolTemplatable(messagesConfig?.activationComments, true)) {
+ core.info("activation-comments is disabled: skipping completion comment update");
+ return;
+ }
+
  core.info(`Comment ID: ${commentId}`);
  core.info(`Comment Repo: ${commentRepo}`);
  core.info(`Run URL: ${runUrl}`);

actions/setup/js/update_activation_comment.cjs

@@ -4,6 +4,20 @@
 const { getErrorMessage } = require("./error_helpers.cjs");
 const { getMessages } = require("./messages_core.cjs");
 const { sanitizeContent } = require("./sanitize_content.cjs");
+const { getPullRequestCreatedMessage, getIssueCreatedMessage, getCommitPushedMessage } = require("./messages_run_status.cjs");
+const { parseBoolTemplatable } = require("./templatable.cjs");
+const { generateXMLMarker } = require("./generate_footer.cjs");
+
+/**
+ * Build the workflow run URL from context and environment.
+ * @param {any} context - GitHub Actions context
+ * @returns {string} The workflow run URL
+ */
+function getRunUrl(context) {
+ const runId = context.runId || process.env.GITHUB_RUN_ID || "";
+ const githubServer = process.env.GITHUB_SERVER_URL || "https://github.com";
+ return context.payload?.repository?.html_url ? `${context.payload.repository.html_url}/actions/runs/${runId}` : `${githubServer}/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
+}
 
 /**
  * Update the activation comment with a link to the created pull request or issue
@@ -16,7 +30,10 @@ const { sanitizeContent } = require("./sanitize_content.cjs");
  */
 async function updateActivationComment(github, context, core, itemUrl, itemNumber, itemType = "pull_request") {
  const itemLabel = itemType === "issue" ? "issue" : "pull request";
- const linkMessage = itemType === "issue" ? `\n\n✅ Issue created: [#${itemNumber}](${itemUrl})` : `\n\n✅ Pull request created: [#${itemNumber}](${itemUrl})`;
+ const workflowName = process.env.GH_AW_WORKFLOW_NAME || "Workflow";
+ const runUrl = getRunUrl(context);
+ const body = itemType === "issue" ? getIssueCreatedMessage({ itemNumber, itemUrl }) : getPullRequestCreatedMessage({ itemNumber, itemUrl });
+ const linkMessage = `\n\n${body}\n\n${generateXMLMarker(workflowName, runUrl)}`;
  await updateActivationCommentWithMessage(github, context, core, linkMessage, itemLabel, { targetIssueNumber: itemNumber });
 }
 
@@ -32,7 +49,9 @@ async function updateActivationComment(github, context, core, itemUrl, itemNumbe
  */
 async function updateActivationCommentWithCommit(github, context, core, commitSha, commitUrl, options = {}) {
  const shortSha = commitSha.substring(0, 7);
- const message = `\n\n✅ Commit pushed: [\`${shortSha}\`](${commitUrl})`;
+ const workflowName = process.env.GH_AW_WORKFLOW_NAME || "Workflow";
+ const runUrl = getRunUrl(context);
+ const message = `\n\n${getCommitPushedMessage({ commitSha, shortSha, commitUrl })}\n\n${generateXMLMarker(workflowName, runUrl)}`;
  await updateActivationCommentWithMessage(github, context, core, message, "commit", options);
 }
 
@@ -54,6 +73,12 @@ async function updateActivationCommentWithMessage(github, context, core, message
  const messagesConfig = getMessages();
  const appendOnlyComments = messagesConfig?.appendOnlyComments === true;
 
+ // Check if activation comments are disabled entirely
+ if (!parseBoolTemplatable(messagesConfig?.activationComments, true)) {
+ core.info("activation-comments is disabled: skipping activation comment update");
+ return;
+ }
+
  // Parse comment repo (format: "owner/repo") with validation
  let repoOwner = context.repo.owner;
  let repoName = context.repo.repo;