diff --git a/breaking/entrypoint.sh b/breaking/entrypoint.sh index c5fdd88..8033425 100755 --- a/breaking/entrypoint.sh +++ b/breaking/entrypoint.sh @@ -134,7 +134,22 @@ if [ -n "$breaking_changes" ] && ! echo "$breaking_changes" | head -n 1 | grep - if [ -z "$base_sha" ]; then base_sha=$(git rev-parse "origin/$GITHUB_BASE_REF" 2>/dev/null || echo "$GITHUB_BASE_REF"); fi free_review_url="https://www.oasdiff.com/review?owner=${owner}&repo=${repo}&base_sha=$(urlencode "$base_sha")&rev_sha=${head_sha}&base_file=$(urlencode "$base_path")&rev_file=$(urlencode "$rev_path")" echo "::notice::📋 Review & approve these breaking changes → ${free_review_url}" - echo "### 📋 [Review & approve these breaking changes](${free_review_url})" >> "$GITHUB_STEP_SUMMARY" + # The Step Summary surfaces both the link (for visitors who'd rather use + # the web UI) and the CLI command itself (for visitors who recognize it + # and want to skip the instruction-page detour). GitHub renders the + # fenced code block with a built-in copy button, so the one-step path + # for the familiar-visitor cohort is: scroll to the Checks tab, click + # copy on the command, paste into a terminal in the local clone, run. + # See enterprise/docs/cli-local-review.md (Phase 1, step 5). + { + echo "### 📋 [Review & approve these breaking changes](${free_review_url})" + echo "" + echo "Or run locally in your clone of \`${repo}\`:" + echo "" + echo '```bash' + echo "oasdiff breaking ${base_sha}:${base_path} ${head_sha}:${rev_path} --open" + echo '```' + } >> "$GITHUB_STEP_SUMMARY" else write_output "No breaking changes" fi diff --git a/changelog/entrypoint.sh b/changelog/entrypoint.sh index 090475e..1aebe8a 100755 --- a/changelog/entrypoint.sh +++ b/changelog/entrypoint.sh @@ -125,7 +125,20 @@ if [ -n "$output" ] && ! echo "$output" | head -n 1 | grep -q "^No "; then if [ -z "$base_sha" ]; then base_sha=$(git rev-parse "origin/$GITHUB_BASE_REF" 2>/dev/null || echo "$GITHUB_BASE_REF"); fi free_review_url="https://www.oasdiff.com/review?owner=${owner}&repo=${repo}&base_sha=$(urlencode "$base_sha")&rev_sha=${head_sha}&base_file=$(urlencode "$base_path")&rev_file=$(urlencode "$rev_path")" echo "::notice::📋 Review & approve these API changes → ${free_review_url}" - echo "### 📋 [Review & approve these API changes](${free_review_url})" >> "$GITHUB_STEP_SUMMARY" + # The Step Summary surfaces both the link (for visitors who'd rather use + # the web UI) and the CLI command itself (for visitors who recognize it + # and want to skip the instruction-page detour). GitHub renders the + # fenced code block with a built-in copy button. See + # enterprise/docs/cli-local-review.md (Phase 1, step 5). + { + echo "### 📋 [Review & approve these API changes](${free_review_url})" + echo "" + echo "Or run locally in your clone of \`${repo}\`:" + echo "" + echo '```bash' + echo "oasdiff changelog ${base_sha}:${base_path} ${head_sha}:${rev_path} --open" + echo '```' + } >> "$GITHUB_STEP_SUMMARY" else write_output "No changelog changes" fi