chore: Bug fixes and improvements to review agents and workflow [NOTASK]

[justinegeffen]

Critical bugfixes:

• Bash syntax error fix (line 71)
• Missing workflow dependency fix (summary job)
• Test workflow for validation

Enhanced features:

• PR type classification (rename vs content)
• Conditional agent execution (skip voice-tone/terminology for renames)
• 60 suggestion limit for manageable reviews
• Full suggestions list downloadable as artifact

[netlify]

✅ Deploy Preview for seqera-docs ready!

Name	Link
🔨 Latest commit	72127a2
🔍 Latest deploy log	https://app.netlify.com/projects/seqera-docs/deploys/697d1ecf11d4f30008b20727
😎 Deploy Preview	https://deploy-preview-1092--seqera-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Copilot]

Pull request overview

This PR refactors the documentation review workflow to use GitHub inline suggestions instead of separate comment-based reviews. The changes consolidate multiple review agents (voice-tone, terminology, clarity) to output structured suggestions that can be applied with a single click in the GitHub PR interface.

Changes:

• Replaces comment-based review workflow with inline GitHub suggestions
• Adds new bash script to convert agent findings into GitHub suggestion format
• Disables the clarity review agent and auto-fix workflows temporarily
• Updates documentation to reflect new inline suggestion workflow

Reviewed changes

Copilot reviewed 1 out of 1 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
platform-enterprise_docs/enterprise/test-editorial-review.md	Removes test file used for agent validation
CLAUDE.md	Updates PR review instructions to document inline suggestion workflow
.github/workflows/docs-review.yml	Refactors workflow to generate structured output and post inline suggestions
.github/workflows/claude-pr-review.yml	Disables this workflow in favor of docs-review.yml
.github/scripts/post-inline-suggestions.sh	New script to convert agent findings to GitHub review suggestions
.github/scripts/example-review.txt	Example input format for the new script
.github/scripts/README.md	Documentation for the new script
.claude/agents/terminology.md	Updates terminology guidelines with Tower usage context

Comments suppressed due to low confidence (2)

.github/scripts/post-inline-suggestions.sh:95

• The script accumulates suggestion text with trailing newlines (lines 92, 95), which means the final suggestion will end with an extra newline. This could cause GitHub suggestions to not match properly or add unwanted blank lines. Consider trimming trailing newlines from current_suggestion before adding it to the comment_body, or handle the last line without appending a newline.

    elif [[ "$in_original" == true ]]; then
      current_original+="$line"$'\n'

    elif [[ "$in_suggestion" == true ]]; then
      current_suggestion+="$line"$'\n'

.github/scripts/post-inline-suggestions.sh:79

• On line 77, current_line is passed as --argjson, which expects a JSON value. However, current_line contains a string from BASH_REMATCH[1]. While the jq expression includes tonumber, it would be more robust to validate that current_line is numeric before using it, or use --arg instead and convert it within jq. If current_line contains non-numeric characters, this could cause jq to fail.

        comments=$(jq -n \
          --argjson comments "$comments" \
          --arg path "$current_file" \
          --argjson line "$current_line" \
          --arg body "$comment_body" \
          '$comments + [{"path": $path, "line": ($line | tonumber), "body": $body}]')

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 11 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.