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;