Add interactive helper script and update documentation for posting remediation comment

Co-authored-by: dcasati <3240777+dcasati@users.noreply.github.com>

Author: Copilot

Act-3/remediation/README.md

@@ -4,10 +4,35 @@ This directory contains root cause analysis and remediation recommendations for
 
 ## How to Post Remediation Comments to GitHub Issues
 
-### Option 1: Using GitHub CLI (Recommended)
+### Option 1: Using the Helper Script (Easiest)
 
 ```bash
-# Authenticate with GitHub
+# From the repository root
+bash Act-3/remediation/post-comment.sh
+```
+
+This interactive script will:
+- Check if GitHub CLI is installed and authenticated
+- Confirm before posting
+- Post the comment to issue #12
+- Show you the URL to view the comment
+
+### Option 2: Using GitHub CLI Directly
+
+```bash
+# Authenticate with GitHub (if not already)
+gh auth login
+
+# Post the comment
+gh issue comment 12 \
+  --repo DevExpGbb/agentic-platform-engineering \
+  --body-file Act-3/remediation/issue-12-argocd-deployment-failure.md
+```
+
+### Option 2: Using GitHub CLI Directly
+
+```bash
+# Authenticate with GitHub (if not already)
 gh auth login
 
 # Post the comment
@@ -16,7 +41,19 @@ gh issue comment 12 \
   --body-file Act-3/remediation/issue-12-argocd-deployment-failure.md
 ```
 
-### Option 2: Using GitHub Actions Workflow
+### Option 3: Using GitHub Actions Workflow
+
+A workflow has been created at `.github/workflows/post-issue-comment.yml` that can be manually triggered:
+
+1. Go to Actions tab in GitHub
+2. Select "Post Issue Comment" workflow  
+3. Click "Run workflow"
+4. Enter:
+   - Issue number: `12`
+   - Comment file: `Act-3/remediation/issue-12-argocd-deployment-failure.md`
+5. Click "Run workflow"
+
+### Option 3: Using GitHub Actions Workflow
 
 A workflow has been created at `.github/workflows/post-issue-comment.yml` that can be manually triggered:
 
@@ -28,7 +65,22 @@ A workflow has been created at `.github/workflows/post-issue-comment.yml` that c
    - Comment file: `Act-3/remediation/issue-12-argocd-deployment-failure.md`
 5. Click "Run workflow"
 
-### Option 3: Using GitHub API directly
+### Option 4: Using GitHub API directly
+
+```bash
+# Set your GitHub token
+export GITHUB_TOKEN="your_token_here"
+
+# Post the comment
+curl -X POST \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  https://api.github.com/repos/DevExpGbb/agentic-platform-engineering/issues/12/comments \
+  -d @<(jq -Rs '{"body": .}' < Act-3/remediation/issue-12-argocd-deployment-failure.md)
+```
+
+### Option 4: Using GitHub API directly
 
 ```bash
 # Set your GitHub token
@@ -43,7 +95,7 @@ curl -X POST \
   -d @<(jq -Rs '{"body": .}' < Act-3/remediation/issue-12-argocd-deployment-failure.md)
 ```
 
-### Option 4: Manual Copy-Paste
+### Option 5: Manual Copy-Paste
 
 1. Open the file: `Act-3/remediation/issue-12-argocd-deployment-failure.md`
 2. Copy the entire contents
@@ -54,4 +106,5 @@ curl -X POST \
 ## Files in This Directory
 
 - `issue-12-argocd-deployment-failure.md` - Comprehensive root cause analysis and remediation recommendations for the `2-broken-apps` ArgoCD deployment failure
+- `post-comment.sh` - Interactive helper script to post the comment (requires gh CLI)
 - `README.md` - This file, with instructions on how to post the remediation comments

Act-3/remediation/post-comment.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+
+# Quick Post Comment Script
+# This script posts the remediation comment to GitHub issue #12
+# 
+# Prerequisites:
+# - GitHub CLI (gh) installed
+# - Authenticated with: gh auth login
+# 
+# Usage:
+#   cd /path/to/repo
+#   bash Act-3/remediation/post-comment.sh
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+COMMENT_FILE="$SCRIPT_DIR/issue-12-argocd-deployment-failure.md"
+
+ISSUE_NUMBER=12
+REPO="DevExpGbb/agentic-platform-engineering"
+
+echo "═══════════════════════════════════════════════════════════"
+echo "  ArgoCD Deployment Failure - Post Remediation Comment"
+echo "═══════════════════════════════════════════════════════════"
+echo ""
+
+# Check if gh is installed
+if ! command -v gh &> /dev/null; then
+    echo "❌ Error: GitHub CLI (gh) is not installed"
+    echo ""
+    echo "Install it from: https://cli.github.com/"
+    echo ""
+    echo "Or use an alternative method from README.md"
+    exit 1
+fi
+
+# Check if authenticated
+if ! gh auth status &> /dev/null; then
+    echo "❌ Error: Not authenticated with GitHub CLI"
+    echo ""
+    echo "Please authenticate with: gh auth login"
+    echo ""
+    exit 1
+fi
+
+# Check if comment file exists
+if [ ! -f "$COMMENT_FILE" ]; then
+    echo "❌ Error: Comment file not found at: $COMMENT_FILE"
+    exit 1
+fi
+
+echo "✓ GitHub CLI installed and authenticated"
+echo "✓ Comment file found: $(basename $COMMENT_FILE)"
+echo ""
+echo "Repository: $REPO"
+echo "Issue: #$ISSUE_NUMBER"
+echo ""
+echo "───────────────────────────────────────────────────────────"
+read -p "Post comment to issue #$ISSUE_NUMBER? (y/N): " -n 1 -r
+echo ""
+echo "───────────────────────────────────────────────────────────"
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo ""
+    echo "❌ Cancelled by user"
+    exit 0
+fi
+
+echo ""
+echo "Posting comment..."
+echo ""
+
+# Post the comment
+gh issue comment "$ISSUE_NUMBER" \
+    --repo "$REPO" \
+    --body-file "$COMMENT_FILE"
+
+echo ""
+echo "✅ Comment posted successfully!"
+echo ""
+echo "View at: https://github.com/$REPO/issues/$ISSUE_NUMBER"
+echo ""