Add debug/

Signed-off-by: Aaron Wislang <[email protected]>

Author: asw101

debug/Justfile

@@ -0,0 +1,103 @@
+set shell := ["bash", "-uc"]
+
+# List available recipes
+list:
+    just --list
+
+# Get logs from the latest GitHub Actions workflow run
+get-latest-logs output="latest-run.log":
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    echo "Fetching latest workflow run..."
+    
+    # Get the latest run ID
+    RUN_ID=$(gh run list --limit 1 --json databaseId --jq '.[0].databaseId')
+    
+    if [ -z "$RUN_ID" ]; then
+        echo "Error: No workflow runs found"
+        exit 1
+    fi
+    
+    echo "Latest run ID: $RUN_ID"
+    
+    # Get the logs and save to file
+    gh run view "$RUN_ID" --log > "{{output}}"
+    
+    echo "Logs saved to: {{output}}"
+    echo "Run 'just analyze-logs' to get AI analysis of the failure"
+
+# Get logs from a specific workflow run by ID
+get-logs run_id output="run.log":
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    echo "Fetching logs for run ID: {{run_id}}"
+    gh run view {{run_id}} --log > "{{output}}"
+    echo "Logs saved to: {{output}}"
+
+# List recent workflow runs
+list-runs limit="10":
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    echo "Recent workflow runs:"
+    gh run list --limit {{limit}} --json databaseId,status,conclusion,name,createdAt,displayTitle
+
+# Get detailed status of the latest workflow run
+status-latest:
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    echo "Latest workflow run status:"
+    gh run list --limit 1 --json databaseId,status,conclusion,name,createdAt,displayTitle,workflowName,event,headBranch
+    echo ""
+    echo "Jobs in latest run:"
+    RUN_ID=$(gh run list --limit 1 --json databaseId --jq '.[0].databaseId')
+    gh run view "$RUN_ID"
+
+# Get logs from the latest failed workflow run
+get-failed-logs output="failed-run.log":
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    echo "Fetching latest failed workflow run..."
+    
+    # Get the latest failed run ID
+    RUN_ID=$(gh run list --limit 50 --json databaseId,conclusion --jq '.[] | select(.conclusion=="failure") | .databaseId' | head -n 1)
+    
+    if [ -z "$RUN_ID" ]; then
+        echo "Error: No failed workflow runs found in the last 50 runs"
+        exit 1
+    fi
+    
+    echo "Latest failed run ID: $RUN_ID"
+    
+    # Get the logs and save to file
+    gh run view "$RUN_ID" --log > "{{output}}"
+    
+    echo "Logs saved to: {{output}}"
+    echo "Run 'just analyze-logs {{output}}' to get AI analysis of the failure"
+
+# Watch workflow runs in real-time
+watch:
+    gh run watch
+
+# Re-run the latest failed workflow
+rerun-failed:
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    RUN_ID=$(gh run list --limit 50 --json databaseId,conclusion --jq '.[] | select(.conclusion=="failure") | .databaseId' | head -n 1)
+    if [ -z "$RUN_ID" ]; then
+        echo "Error: No failed workflow runs found"
+        exit 1
+    fi
+    echo "Re-running failed workflow: $RUN_ID"
+    gh run rerun "$RUN_ID"
+
+# Cancel the latest running workflow
+cancel-latest:
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    RUN_ID=$(gh run list --limit 1 --json databaseId,status --jq '.[] | select(.status=="in_progress") | .databaseId' | head -n 1)
+    if [ -z "$RUN_ID" ]; then
+        echo "No running workflows found"
+        exit 1
+    fi
+    echo "Cancelling workflow run: $RUN_ID"
+    gh run cancel "$RUN_ID"

debug/README.md

@@ -0,0 +1,136 @@
+# Debug Utilities
+
+This directory contains utilities for debugging GitHub Actions workflows and other CI/CD issues.
+
+## Prerequisites
+
+- [GitHub CLI (`gh`)](https://cli.github.com/) - Already installed in the devcontainer
+- GitHub authentication configured (`gh auth login`)
+
+## Available Commands
+
+Run `just` to see all available recipes and their descriptions:
+
+```bash
+cd debug
+just
+```
+
+## Quick Start
+
+### Get Logs from the Latest Workflow Run
+
+```bash
+cd debug
+just get-latest-logs
+```
+
+This will save the logs to `latest-run.log`.
+
+### Get Logs from the Latest Failed Run
+
+```bash
+just get-failed-logs
+```
+
+This will find the most recent failed workflow run and save its logs to `failed-run.log`.
+
+## Usage Examples
+
+### Example 1: Debug the Latest Failure
+
+```bash
+cd debug
+
+# Get logs from the latest failed run
+just get-failed-logs
+
+# Review the logs
+cat failed-run.log
+```
+
+### Example 2: Check Recent Runs
+
+```bash
+cd debug
+
+# List the last 20 runs
+just list-runs 20
+
+# Get detailed status of the latest run
+just status-latest
+```
+
+### Example 3: Debug a Specific Run
+
+```bash
+cd debug
+
+# List runs to find the ID you want
+just list-runs
+
+# Get logs for a specific run (e.g., run ID 12345678)
+just get-logs 12345678 my-debug.log
+```
+
+### Example 4: Real-time Monitoring
+
+```bash
+cd debug
+
+# Watch workflows in real-time
+just watch
+
+# In another terminal, if a run fails:
+just get-latest-logs
+```
+
+### Example 5: Custom Output Location
+
+```bash
+cd debug
+
+# Save logs to a custom location
+just get-latest-logs output="../logs/workflow-$(date +%Y%m%d-%H%M%S).log"
+```
+
+## Workflow
+
+A typical debugging workflow:
+
+1. **Check what failed:**
+   ```bash
+   just list-runs
+   ```
+
+2. **Get the logs:**
+   ```bash
+   just get-failed-logs
+   ```
+
+3. **Review and analyze the failure:**
+   ```bash
+   cat failed-run.log
+   # Or use your preferred AI tool to analyze the logs
+   ```
+
+4. **Make fixes to your code**
+
+5. **Re-run the workflow:**
+   ```bash
+   just rerun-failed
+   ```
+
+6. **Monitor the re-run:**
+   ```bash
+   just watch
+   ```
+
+## Tips
+
+- Run `just` to see all available commands
+- Use `just list-runs` first to see the status of recent runs
+- The `get-failed-logs` recipe searches the last 50 runs for failures
+- Log files are saved in the current directory by default
+- You can specify custom output paths for any log-fetching recipe
+- Analyze log files with your preferred AI tool for debugging insights