Add helper script and documentation for posting issue analysis

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

Author: Copilot

.github/README_ANALYSIS.md

@@ -0,0 +1,62 @@
+# ArgoCD Deployment Failure Analysis
+
+## Summary
+
+This directory contains the root cause analysis for the ArgoCD deployment failure of the `2-broken-apps` application reported in [Issue #12](https://github.com/DevExpGbb/agentic-platform-engineering/issues/12).
+
+## Quick Start
+
+To post the analysis as a comment on the GitHub issue, use one of these methods:
+
+### Method 1: GitHub CLI (Recommended)
+
+```bash
+gh issue comment 12 --body-file .github/ISSUE_12_ANALYSIS.md
+```
+
+### Method 2: GitHub Actions Workflow
+
+Trigger the workflow manually from the Actions tab or via CLI:
+
+```bash
+gh workflow run post-issue-analysis.yml -f issue_number=12
+```
+
+### Method 3: Bash Script
+
+Run the provided script:
+
+```bash
+./.github/scripts/post-to-issue.sh 12
+```
+
+### Method 4: Manual Copy-Paste
+
+1. Open the issue: https://github.com/DevExpGbb/agentic-platform-engineering/issues/12
+2. Copy the contents of `.github/ISSUE_12_ANALYSIS.md`
+3. Paste into a new comment
+
+## Files
+
+- **ISSUE_12_ANALYSIS.md** - Complete root cause analysis and remediation recommendations
+- **workflows/post-issue-analysis.yml** - GitHub Actions workflow to post the analysis
+- **scripts/post-to-issue.sh** - Bash script to post the analysis
+- **scripts/post-issue-analysis.js** - Node.js helper script
+- **README_ANALYSIS.md** - This file
+
+## Root Cause (TL;DR)
+
+The deployment is failing due to an **invalid Kubernetes API version** in the manifest file:
+
+**File:** `apps/broken-aks-store-all-in-one.yaml` (line 178) in the external repository  
+**Issue:** `apiVersion: apps/v` should be `apiVersion: apps/v1`
+
+This was intentionally broken for testing ArgoCD notification workflows (commit message: "break apiVersion formatting in deployment YAML").
+
+## Remediation Options
+
+1. **Fix the source repository** - Correct the `apiVersion` field in the YAML file
+2. **Point to a different source** - Update the ArgoCD Application to use a working repository
+3. **Use resource exclusion** - Temporarily exclude the broken deployment while investigating
+
+See the full analysis in `ISSUE_12_ANALYSIS.md` for detailed remediation steps.

.github/scripts/post-to-issue.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+
+# Post Issue Analysis to GitHub
+# This script posts the root cause analysis to a GitHub issue
+
+set -e
+
+ISSUE_NUMBER="${1:-12}"
+ANALYSIS_FILE=".github/ISSUE_12_ANALYSIS.md"
+REPO_OWNER="DevExpGbb"
+REPO_NAME="agentic-platform-engineering"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "================================================"
+echo "  GitHub Issue Analysis Poster"
+echo "================================================"
+echo ""
+
+# Check if analysis file exists
+if [ ! -f "$ANALYSIS_FILE" ]; then
+    echo -e "${RED}Error: Analysis file not found at $ANALYSIS_FILE${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Analysis file found${NC}"
+
+# Clean the comment body (remove the note section)
+COMMENT_BODY=$(sed '/^---$/,$ d' "$ANALYSIS_FILE" | sed -e 's/$/\\n/' | tr -d '\n')
+
+# Method 1: Try gh CLI
+if command -v gh &> /dev/null && [ -n "$GITHUB_TOKEN" ] || gh auth status &> /dev/null 2>&1; then
+    echo -e "${GREEN}Using GitHub CLI...${NC}"
+    gh issue comment "$ISSUE_NUMBER" --body-file "$ANALYSIS_FILE"
+    echo -e "${GREEN}✓ Comment posted successfully using gh CLI!${NC}"
+    exit 0
+fi
+
+# Method 2: Try curl with GITHUB_TOKEN
+if [ -n "$GITHUB_TOKEN" ]; then
+    echo -e "${GREEN}Using curl with GITHUB_TOKEN...${NC}"
+    
+    RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+        -H "Accept: application/vnd.github+json" \
+        -H "Authorization: Bearer $GITHUB_TOKEN" \
+        -H "X-GitHub-Api-Version: 2022-11-28" \
+        "https://api.github.com/repos/$REPO_OWNER/$REPO_NAME/issues/$ISSUE_NUMBER/comments" \
+        -d @<(jq -Rs '{body: .}' < "$ANALYSIS_FILE"))
+    
+    HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+    BODY=$(echo "$RESPONSE" | sed '$d')
+    
+    if [ "$HTTP_CODE" = "201" ]; then
+        echo -e "${GREEN}✓ Comment posted successfully using curl!${NC}"
+        COMMENT_URL=$(echo "$BODY" | jq -r '.html_url')
+        echo "Comment URL: $COMMENT_URL"
+        exit 0
+    else
+        echo -e "${RED}✗ Failed to post comment. HTTP code: $HTTP_CODE${NC}"
+        echo "$BODY" | jq .
+        exit 1
+    fi
+fi
+
+# Method 3: Provide instructions for manual posting
+echo -e "${YELLOW}No authentication method available.${NC}"
+echo ""
+echo "To post this analysis to issue #$ISSUE_NUMBER, use one of these methods:"
+echo ""
+echo "Method 1 - GitHub CLI:"
+echo "  gh issue comment $ISSUE_NUMBER --body-file $ANALYSIS_FILE"
+echo ""
+echo "Method 2 - GitHub Web UI:"
+echo "  1. Go to: https://github.com/$REPO_OWNER/$REPO_NAME/issues/$ISSUE_NUMBER"
+echo "  2. Copy the contents of: $ANALYSIS_FILE"
+echo "  3. Paste into a new comment"
+echo ""
+echo "Method 3 - Trigger the workflow:"
+echo "  gh workflow run post-issue-analysis.yml -f issue_number=$ISSUE_NUMBER"
+echo ""
+echo "Method 4 - Use curl with your token:"
+echo "  export GITHUB_TOKEN=your_token_here"
+echo "  bash .github/scripts/post-to-issue.sh $ISSUE_NUMBER"
+echo ""
+
+exit 1