Skip to content

Track blockers with native issue dependencies instead of the blocker-line guard #5051

Description

@devantler

Why

The blocker-line guard (~8.4k lines, mostly Go, 24 commits in 60 days) parses **Blocker:** lines in issue bodies and cross-checks the blocked label. GitHub issue dependencies already express this, and the guides use them in places, so both systems run side by side.

What

Record blockers that are issues as native dependencies (issue dependencies), readable with gh issue view --json blockedBy. Keep a tiny check only for blockers that are not issues and for parked PRs, or file an issue for those blockers so they become dependencies too.

What is lost

Nothing, if the small residual check stays.

First step

Count open blocker lines that name an issue, convert them, and shrink the guard to the remainder.

Part of #5047.

🤖 Generated with Claude Code

Activity

  1. devantler commented on Nov 14, 2026

    @devantler
    ContributorAuthor

    Design for the full rewrite (maintainer chose it in an interactive session on 2026-11-14).

    Census today: 40 open blocked issues. 8 name an in-org issue, 8 an external issue, and about 25 are authority, outcome or prose blockers. 22 open PRs carry blocked. 13 issues already have native blockers, including one across owners, so cross-owner links work.

    New model: every blocker is an issue.

    • Blocked issue = the blocked label plus at least one open native blocked by issue. The issue's state is the verification. No **Blocker:** line, no last-verified dates.

      • Upstream issue: link it directly, in any repository.
      • Authority: link the open maintainer-ask issue. Closing the ask unblocks.
      • Outcome or event (a release, the next deploy): file a small "Wait for: …" issue in the same repository and link it. Whoever sees the event close it.
    • Parked PR = the blocked label plus one comment by the maintainer account whose first line is the disclosure and which carries Blocked by <owner/repo#N>, naming an issue as above. PRs cannot take native dependencies, so this one line stays. It is edited in place, never posted twice.

    • Residual check blocked-check.sh --org devantler-tech: bash and GraphQL, read-only, about 150 lines. Rows:

      • STRANDED: labelled, but no open blocker. Work it or remove the label.
      • MISSING: labelled, but no blocker recorded at all.
      • UNLABELLED: has an open native blocker but no label.
      • PARKED: settled.

      Exit codes are 0, 1 and 2 as usual.

    • Removed: the Go guard (park, unpark, compose, parked digest, stale and ask checks) and its CI job. The ETag-conditional reader that lane-draft-count.sh borrows moves to a small forge-read-go module unchanged, so the request budget saving from Agent runs exhaust the shared GitHub request budget and make product release steps fail #4055 stays.

    • Dropped: the UNRECORDED row for stale unstarted Security issues. It is not a blocker check. The advisory sweep and rung 2 of the ladder still cover security work.

    Migration: one pass converts every open blocked issue and parked PR. It creates the "Wait for" issues and native links, rewrites each PR record to the one-line form, and removes the old **Blocker:** lines only after the link reads back. Then the guides (work selection, merge policy and its sensors, the run skill) are rewritten to the new model in the same PR.

    Implementation follows in one draft PR. The maintainer approves before it is marked ready, because it changes live lane behaviour.

    🤖 Generated with Claude Code

  2. moved this to 🏃🏻‍♂️ In Progress in 🌊 Project Boardon Nov 14, 2026
  3. moved this from 🏃🏻‍♂️ In Progress to ✅ Done in 🌊 Project Boardon Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Fields

    No fields configured for Refactor.

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions