Add comment creation for issue/PR reactions with workflow run links

[Copilot]

Task: Add comment with workflow run link for issue/PR reactions

Problem Statement

When an agentic workflow is triggered by an issue or pull request and has the "reaction" frontmatter enabled, the add_reaction job should:

1. Add a comment pointing to the workflow run (in addition to adding the reaction)
2. Expose the comment ID as an output of the job

Implementation Plan

• Explore repository structure and understand current code
• Update add_reaction_and_edit_comment.cjs to create comments for issues and pull_request events
• Add comment ID output to the job outputs in reaction.go
• Add unit tests for the new functionality
• Run existing tests to ensure no regressions
• Run make recompile to update compiled workflows
• Run make agent-finish before final commit
• Update documentation for reaction feature
• Use Astro Starlight adornment style for notes

Changes Made

1. JavaScript (add_reaction_and_edit_comment.cjs):

   • For issues events: Now creates a new comment with workflow run link instead of just adding a reaction
   • For pull_request events: Now creates a new comment with workflow run link instead of just adding a reaction
   • Renamed editCommentWithWorkflowLink to addOrEditCommentWithWorkflowLink to handle both comment creation and editing
   • Added logic to differentiate between creating new comments (for issues/PRs) and editing existing comments (for comment events)
   • Sets comment-id and comment-url outputs when creating comments

2. Go (reaction.go):

   • Added comment_id and comment_url to job outputs map
   • These outputs are now available to downstream jobs

3. Tests:

   • Updated compiler_test.go to match new function name addOrEditCommentWithWorkflowLink
   • Added reaction_outputs_test.go to verify comment outputs are properly exposed
   • All tests passing

4. Documentation:

   • Updated docs/src/content/docs/reference/frontmatter.md to document the new reaction behavior
   • Added Behavior section explaining when comments are created vs edited
   • Added Outputs section documenting reaction_id, comment_id, and comment_url
   • Updated docs/src/content/docs/reference/command-triggers.md to clarify the difference between command workflows and non-command workflows with reactions
   • Converted notes to Astro Starlight :::note adornment style

Example Output

When an issue or PR is opened with a reaction-enabled workflow:

YAML outputs:

add_reaction:
  needs: activation
  outputs:
    comment_id: ${{ steps.react.outputs.comment-id }}
    comment_url: ${{ steps.react.outputs.comment-url }}
    reaction_id: ${{ steps.react.outputs.reaction-id }}

JavaScript behavior:

• For issues event: Creates comment with text like > Agentic [workflow run](URL) triggered by this issue
• For pull_request event: Creates comment with text like > Agentic [workflow run](URL) triggered by this pull request
• For comment events (issue_comment, etc.): Edits existing comment (preserves original behavior)

Technical Approach

The change is minimal and focused:

• Reused existing GitHub API patterns from add_comment.cjs
• Maintained backward compatibility for comment events (issue_comment, pull_request_review_comment)
• Added proper error handling with warnings instead of failures
• All changes pass linting, formatting, and testing

Original prompt

A agentic workflow that is triggered by a pull request/issue and has the "reaction" front matter enabled should add a pull request/issue comment pointing to the workflow run.

• update add comment JavaScript to handle this case in add_reaction job
• expose comment id as output of the job

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot update docs on reaction

[Copilot]

@copilot update docs on reaction

Updated documentation in commit e65ccba. Changes include:

• Added Behavior section to frontmatter.md explaining when comments are created vs edited
• Added Outputs section documenting reaction_id, comment_id, and comment_url
• Updated command-triggers.md to clarify the difference between command workflows and non-command workflows with reactions

[pelikhan]

@copilot use Astro Starlight adornment style for notes in docs

[Copilot]

@copilot use Astro Starlight adornment style for notes in docs

Converted to Starlight adornment style in commit 87bce49. Changed **Note**: to :::note format in command-triggers.md.