feat: /codeboarding posts a new comment per run instead of updating in place

On-demand /codeboarding (issue_comment) now uses a run-unique sticky
header, so each invocation creates a fresh comment and leaves earlier
ones (the auto on-open comment and prior /codeboarding results) intact.
Automatic pull_request runs keep the stable header and update in place
as before. The header is resolved once in the guard step (written up
front so the failure-comment step always has it).

Author: brovatten

README.md

@@ -145,7 +145,7 @@ This table mirrors the engine and may lag it. The source of truth is the engine'
 ## When it runs
 
 - On a PR being opened, reopened, or marked ready for review, the diagram is generated once (per the `on:` triggers above). It does not re-run on every push, so you never spend an LLM job per commit; the comment reflects that point until refreshed.
-- On a `/codeboarding` comment, a trusted collaborator (`OWNER`, `MEMBER`, or `COLLABORATOR`) regenerates the diagram against the current PR head, even if one already exists. It re-runs and updates the same comment in place. Change the keyword via `trigger_command`.
+- On a `/codeboarding` comment, a trusted collaborator (`OWNER`, `MEMBER`, or `COLLABORATOR`) regenerates the diagram against the current PR head, even if one already exists. Each `/codeboarding` invocation posts a **new** comment and leaves earlier comments untouched (the automatic on-open comment, and any previous `/codeboarding` results, stay put). Change the keyword via `trigger_command`.
 
 The command needs the `issue_comment` trigger and runs from your default branch (a GitHub rule), so it only works once the workflow is merged there. On-demand runs on fork PRs are refused, so fork code is never analyzed with your secrets.
 

action.yml

@@ -97,6 +97,20 @@ runs:
         set -uo pipefail
         skip() { echo "::notice::$1 Skipping."; echo "skip=true" >> "$GITHUB_OUTPUT"; exit 0; }
 
+        # Sticky-comment targeting. Written up front so the failure-comment step
+        # always has a header even if PR resolution below fails. Automatic
+        # pull_request runs reuse one stable header → the comment is updated in
+        # place. An on-demand /codeboarding run uses a run-unique header so it
+        # posts a NEW comment and never touches comments from earlier runs; its
+        # own in-progress→result→failure steps still share it (one comment per
+        # invocation). Re-running the same run keeps the same run id, so a re-run
+        # updates that invocation's comment rather than spawning another.
+        if [ "$EVENT" = "issue_comment" ]; then
+          echo "sticky_header=codeboarding-architecture-diff-run-${GITHUB_RUN_ID}" >> "$GITHUB_OUTPUT"
+        else
+          echo "sticky_header=codeboarding-architecture-diff" >> "$GITHUB_OUTPUT"
+        fi
+
         if [ "$EVENT" = "pull_request" ]; then
           PR_NUMBER="$PR_NUMBER_PULL"
           BASE_SHA="$PULL_BASE_SHA"
@@ -160,7 +174,7 @@ runs:
       continue-on-error: true
       uses: marocchino/sticky-pull-request-comment@v2
       with:
-        header: codeboarding-architecture-diff
+        header: ${{ steps.guard.outputs.sticky_header }}
         number: ${{ steps.guard.outputs.pr_number }}
         message: |
           ### ${{ inputs.comment_header }} · analyzing…
@@ -609,7 +623,7 @@ runs:
       if: steps.guard.outputs.skip != 'true'
       uses: marocchino/sticky-pull-request-comment@v2
       with:
-        header: codeboarding-architecture-diff
+        header: ${{ steps.guard.outputs.sticky_header }}
         number: ${{ steps.guard.outputs.pr_number }}
         path: ${{ steps.body.outputs.body_file }}
         GITHUB_TOKEN: ${{ inputs.github_token }}
@@ -621,7 +635,7 @@ runs:
       continue-on-error: true
       uses: marocchino/sticky-pull-request-comment@v2
       with:
-        header: codeboarding-architecture-diff
+        header: ${{ steps.guard.outputs.sticky_header }}
         number: ${{ steps.guard.outputs.pr_number }}
         message: |
           ### ${{ inputs.comment_header }} · failed