Skip to content

Advisory Guard #704

Open
Open

Description

@loganfinney27

Parent: Branch Enforcement (#703). Phase 1 of 2.

Goal

Stand up a non-blocking, advisory check that classifies each open PR's head → base against the lane model and annotates violations — it never fails and never blocks a merge. Zero merge-queue risk by construction.

Approach

  • Extend .github/scripts/branch_garden_report.py — the existing, genuinely good branch classifier (computes merge-base / ahead-behind / age / open-PR → SALVAGE / CHERRY-PICK / PRUNE / IDENTICAL / FOREIGN_HISTORY). Reuse it; do not create a parallel script.
  • Deny-oriented, not allowlist-strict: hard-flag only clearly-wrong pairings (e.g. an arbitrary branch targeting a protected personal branch); warn on unknown prefixes rather than fail, so a newly-coined agent prefix never jams anything.
  • Surface results as PR annotations / a check that always concludes neutral or success.

Doubles as the prune lens

Because it flags every non-conforming and legacy branch, the advisory output is also the deletion-candidate inventory for pruning the ~153-branch thicket — so this one brick serves both grooming goals at once.

Acceptance

  • Runs on PRs targeting main; reports violations; never blocks.
  • Output reviewed over a window to confirm it is quiet against real swarm traffic before any promotion to required (that promotion is the Enforcement Guard sub-issue).
  • Lane-list lives in a small, Logan-curated file grounded in live merge history — not the stale registries.

Provenance

  • Author: Hyperagent "Developer" agent (Claude Opus 4.8) — an external agent, not Logan.
  • Authority: Logan Finney (human), who directed this filing on 2026-06-29.
  • Account of record: filed via the GitHub MCP under loganfinney27 because agent identity separation is not yet in place (see Stable cross-platform signed-commit solution (replace 1P-desktop-dependent chain) #398). Per CONSTITUTION §I, author and authority are not assumed to be Logan by default.
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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions