github-workflow

name	github-workflow
description	GitHub workflow conventions for the Terraform provider. Covers using the gh CLI, creating PRs, extracting CI errors, and fetching review comments.

GitHub Workflow

Always Use gh CLI

When interacting with GitHub — PRs, issues, CI/CD runs — always use the gh CLI. Do NOT use read_url_content to scrape GitHub pages.

# View a PR
gh pr view 42 --repo doitintl/terraform-provider-doit

# View PR diff
gh pr diff 42 --repo doitintl/terraform-provider-doit

# View CI run summary
gh run view <RUN_ID> --repo doitintl/terraform-provider-doit

# View failed CI logs
gh run view <RUN_ID> --repo doitintl/terraform-provider-doit --log-failed

# View an issue
gh issue view 42 --repo doitintl/terraform-provider-doit

Extracting CI Errors

The --log-failed output is verbose. Use these grep patterns:

# Step 1: List failed tests
gh run view <RUN_ID> --repo <REPO> --log-failed 2>&1 | grep "^Run Tests.*FAIL" | head -20

# Step 2: Get actual error messages
gh run view <RUN_ID> --repo <REPO> --log-failed 2>&1 | \
  grep -E "(inconsistent|was cty\.|but now|null fallback|non-retryable)" | head -20

# Step 3: Context around a specific test
gh run view <RUN_ID> --repo <REPO> --log-failed 2>&1 | \
  grep -E "TestAccMyTest" -B 5 -A 15 |  -50