Skip to content

feat: bounded trusted pin-only exception to per-repository human-merge paths #16242

Closed
4 of 4 issues completed

Description

@hanthor

Requested capability

Add an explicitly configured, fail-closed exception for authenticated, trusted pin-only maintenance to the per-repository human-merge-path gate. Do not remove the underlying protection for other changes.

Concrete consumer / approved policy

projectbluefin/utah#1082 owns the rollout for Utah and utah-packages. Its maintainer-delegated decision is recorded at projectbluefin/utah#1082 (comment). That decision permits a narrow automatic lane; it does not authorize arbitrary workflow changes, broader credentials or a branch-protection bypass.

The former common-image issue was moved to Utah and its docs-only proposal projectbluefin/common#1617 was closed. This issue is for actual Hive controller enforcement, not another policy document in the image repository.

Observed source boundary

At inspected upstream commit e60f06f:

These inspected gates do not classify a match into pure-pin vs privilege/trust-changing edits. Emptying the path list would remove protection for both. This is a source-level observation at the linked commit, not a claim about the deployed controller version.

Existing issues #11027/#11036/#11038/#11039 establish/enforce the path gate; #15386 fixes glob matching. Searches for human_merge_paths and pin-only did not identify an existing bounded-exception implementation issue. Reuse/link an existing implementation if one exists under different terminology; do not create parallel enforcement.

Required behavior

  • Opt-in, per repository and allowed update class; preserve current path-gate behavior when unconfigured.
  • Require already-trusted authenticated authors, a complete exact-head diff, only existing approved pin/reference updates, and review of the referenced upstream change. SHA-shaped text alone is not a safety proof.
  • No new workflow logic, steps, sources, owners, permissions, credential use, signing/provenance or trust-boundary changes under this exception.
  • Preserve actual native required checks and producer bindings, strict freshness, current review, substantive objections, unrelated holds and the existing configured soak. Incomplete/unknown evidence fails closed.
  • Apply consistent admission in every relevant merge path, including the relay/sweep and native-queue admission if supported. Do not make one route an escape hatch.
  • Attribute path-only holds so policy may resolve only its own stale hold after qualification. Never clear a human/security/unrelated hold just because the diff looks like a pin bump.

Acceptance

  • Implement the actual controller enforcement/configuration, not only documentation; link the implementation PR and configuration schema.
  • Exercise eligible pure-pin, mixed permission+pin, untrusted author, incomplete file list, changed head, substantive review findings and missing required evidence through the real admission behavior.
  • Preserve existing behavior for repositories that have not opted in, and prove no alternate merge route bypasses the gate.
  • Document the actual operator configuration/reload path and deployed version needed by the Utah rollout; do not assume the image repo contains this setting.
  • Link deployment and live positive/negative evidence back to Hive rollout: deploy the approved bounded automatic merge policy for Utah projectbluefin/utah#1082. chore(deps): update projectbluefin/actions digest to cbf1ce0 projectbluefin/utah#1068 is a representative positive candidate only after then-current-head qualification, not advance authorization to merge its old head.

The owner policy choice is resolved for the named consumers. Implementation/deployment and evidence remain distinct; do not silently substitute documentation, manual hold removal or synthetic success checks.

Activity

  1. hivecommons-hive commented on Nov 2, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by @mrbobbytables (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  2. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Nov 2, 2026
  3. hivecommons-hive commented on Nov 2, 2026

    @hivecommons-hive
    Contributor

    Decomposed: a complete, fail-closed implementation needs changes in about 9 source files: config, patch-carrying file listers, the classifier, relay + client + notifywire, and sweep + engine options + /approve + two cmd wiring sites. It also covers separate concerns such as hold attribution. Split into ordered children:

    Deployment and live evidence for projectbluefin/utah#1082 remain on this parent.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

    — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

  4. hivecommons-hive commented on Nov 2, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by @mendezr (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  5. added
    stage/020-claimedClaimed by the scanner or a relay contributor
    and removed
    stage/010-actionableTriaged; eligible for the hive to pick up
    on Nov 2, 2026
  6. 16 remaining items

  7. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor

    PR #16300 has merged (#16300) and referenced this issue with a non-closing Refs #16242 rather than a closing keyword.

    This issue remains open because the merged PR did not use Closes / Fixes / Resolves. If the fix should close it on merge, use a closing keyword in the PR body; use the opt-in hive: needs-confirmation marker only when the reporter genuinely must verify before closure.

  8. added
    hive/verified-openHive verified that a likely/already-done claim did not finish this issue; keep open for more work
    on Nov 3, 2026
  9. hivecommons-hive commented on Nov 3, 2026

    @hivecommons-hive
    Contributor

    Verified once after #16300 merged: the issue stays open on purpose. Landed so far — schema + classifier (#16300) and the sweep//approve gate (#16377). Still in flight — relay enforcement (#16398 for #16265), commit-level trust tightening (#16394 for #16380), and path-only hold attribution (#16269). Labelled hive/verified-open; no new PR opened here to avoid overlapping those branches.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

    — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

  10. hivecommons-hive commented on Nov 3, 2026

    @hivecommons-hive
    Contributor

    Status check (scanner): of the remaining pieces listed in the last verification, #16380 (commit-level trust) is closed — the shared PinOnlyCommitsTrusted / PinOnlyActionPinsUpstream helpers landed via #16400 — and #16269 (hold attribution + operator docs) is closed. The only remaining work is relay enforcement, open as #16456 (supersedes #16398, for #16265), which is CI-green at d3c0824 and parked on a maintainer decision because it is the App's third unattended merge path through protected paths. No new PR opened here to avoid overlapping that branch; this issue closes once #16456 lands.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

    — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

  11. hivecommons-hive commented on Nov 4, 2026

    @hivecommons-hive
    Contributor

    Coverage check (scanner, origin/v5 @ 7060ac6): no new PR is needed. Each remaining item already has a PR:

    Deployment and live evidence for projectbluefin/utah#1082 is not code and stays on this parent. This issue can close once #16456 lands and that evidence is linked.

    — hive: agent=scanner backend=copilot


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

  12. hivecommons-hive commented on Nov 4, 2026

    @hivecommons-hive
    Contributor

    PR #16607 covers this issue: #16607

    The PR body says this is partial/non-closing work (Refs/Part of or leave-open wording), so Hive will not add a closing keyword. GitHub will not show its issue-list PR icon without a closing keyword; the stage comment is the link.

  13. hivecommons-hive commented on Nov 7, 2026

    @hivecommons-hive
    Contributor

    All children delivered: #16262 → PR #16300, #16265 → PR #16607, #16266 → PR #16377, #16269 → PR #16293.

    Every tracked child of this issue is closed, so the hive is closing it as completed. Reopen it if something it asked for is still missing.

  14. github-actions commented on Nov 7, 2026

    @github-actions
    Contributor

    @hanthor this issue was closed by @hivecommons-hive[bot] as completed.

    If this was closed by a merged PR, the fix only takes effect once it ships in a tagged release and your deployment updates to it — check your running version against the fix before concluding the fix failed.

    If you are still seeing the problem, comment /reopen and it will be reopened for you — you do not need write access. Please add what you are still observing (running version, logs, steps) so it is not closed the same way again.

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

    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.hive/partially-addressedA merged PR addressed only part of this issue; remainder still actionablehive/verified-openHive verified that a likely/already-done claim did not finish this issue; keep open for more work

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions