docs: soften OIDC caveat, document workflow-perms autoflip#1
Merged
Conversation
topcoder1
added a commit
that referenced
this pull request
Apr 30, 2026
Match the new template stub from dotclaude#5. Without this, a docs-only PR on this repo (e.g. README polish) gets paths-ignored, the required 'review / Claude Review' check never reports, and the PR is permanently BLOCKED. Already happened once on PR #1.
topcoder1
added a commit
that referenced
this pull request
May 13, 2026
## Problem The seed-mode design self-committed the seeded value back to the install PR's branch via `GITHUB_TOKEN`. This hits a documented GitHub limitation: **`GITHUB_TOKEN` pushes do NOT re-trigger pull_request workflows**. The self-commit creates a new HEAD SHA with no check runs reported on it — the PR is permanently \"blocked\" without manual `gh pr close + reopen` and an empty user-attributed push. Caught on the first real-world install (whois-api-llc/wxa-jake-ai#389) — required close+reopen + an empty user push to unblock. Doesn't scale to 6+ remaining repos. ## New design **Two-PR flow:** 1. **Install PR** ships `.coverage-floor` with `current=0` (seed marker) + caller workflow. 2. On `pull_request` with `current=0`: PASS. Post comment naming proposed floor. **No self-commit.** 3. Install PR auto-merges naturally (one HEAD SHA, one check set). 4. After merge, `push:main` with `current=0` measures coverage and **opens a follow-up PR** `chore(coverage): seed floor at X.X%` with the seeded `.coverage-floor`. 5. Follow-up PR is 1-file-change, labeled `coverage-floor-seed`, safe-paths-automerge eligible — auto-merges. 6. After follow-up merges, future PRs run in enforce mode. ## Properties - No GITHUB_TOKEN re-trigger problem — each push gets its own workflow run; seed PR is a normal PR with its own checks - Two-PR flow keeps each PR minimal (workflow file + .coverage-floor in #1; just .coverage-floor in #2) - Loop-prevention guard preserved (refuse to seed below `seed_minimum`) - Idempotent: skip if a `coverage-floor-seed` PR is already open - Auto-creates the `coverage-floor-seed` label on first run ## Self-test (this repo) ci-workflows itself stays in enforce mode — `.coverage-floor` here has `current=99.0` against ~100% selftest coverage. The new seed path only fires when `current==0`, so no behavior change on this PR's self-test. ## Companion changes (next PRs) - dotclaude installer (`install-coverage-floor.sh`): docs update — install PR is now passive, expect a follow-up seed PR. ## Auto-merge rationale Workflow file change in ci-workflows — risk:blocked, manual click required (same as #50–#54). 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
README polish based on canary on topcoder1/webcrawl PR #95:
install-pr-review.shauto-flips target repo workflow permissions to write (no longer a manual pre-step).install-pr-review.shcreates a ruleset by default (and how to skip).